1с получить ссылку на документ программно
Обновлено: 07.07.2024
Про реквизит Ссылка
Введение
При изучении запросов ученики часто спрашивают про реквизит Ссылка, который есть, например, у справочников и документов.
Давайте зайдём в базу Гастроном и откроем данные справочника Цвета:
Здесь нажмём на кнопку "Стандартные реквизиты":
Вот она наша Ссылка. Это стандартный реквизит и он есть у многих прикладных типов данных.
Вот примеры его значений:
0xA9BA005056C0000811EAA968D227F09E
0xA9BA005056C0000811EAA968D8B6ACBD
0xA9BA005056C0000811EAA968D8B6ACBE
0xA9BA005056C0000811EAA96D0BC160C1
Вся прелесть этого реквизита в том, что его значение формируется платформой 1С автоматически в момент записи нового объекта в базу данных и является уникальным в пределах прикладного типа, к которому этот реквизит относится.
То есть, например, в справочнике Цвета не может быть двух элементов с одинаковым значением реквизита Ссылка.
А раз так, то значение реквизит Ссылка может использоваться для того, чтобы ссылаться на объект, которому оно принадлежит.
Пример
Представим, что мы создали новый элемент справочника Цвета со следующими значениями реквизитов:
| Реквизит | Значение | Пояснение |
|---|---|---|
| Наименование | Красный | значение этого реквизита указали мы сами при создании элемента |
| Ссылка | 0xA9BA005056C0000811EAA968D227F09C | значение этого реквизита платформа сформировала сама при записи нового элемента в базу данных |
А далее мы создали новый элемент справочника Клиенты со следующими реквизитами:
| Реквизит | Значение | Пояснение |
|---|---|---|
| Наименование | Андрей | значение этого реквизита указали мы сами при создании элемента |
| Пол | Мужской | значение этого реквизита указали мы сами при создании элемента |
| Ссылка | 0xA9BA005056C0000811EAA96D0BC160C0 | значение этого реквизита платформа сформировала сама при записи нового элемента в базу данных |
А теперь самое интересное. У элемента справочника Клиенты есть реквизит ЛюбимыйЦвет, который указывает (ссылается) на элемент справочника Цвета.
Как вы думаете, какое именно значение мы должны записать в реквизит ЛюбимыйЦвет, чтобы он указывал на созданный нами ранее элемент справочника Цвета с наименованием "Красный"?
Верно, в этот реквизит мы должны записать значение реквизита Ссылка этого самого элемента (с наименованием "Красный").
То есть будет вот так:
| Реквизит | Значение | Пояснение |
|---|---|---|
| ЛюбимыйЦвет | 0xA9BA005056C0000811EAA968D227F09C |
Примеры использования в запросах
Пример 1
Как мы уже выяснили, значение поля Ссылка уникально в пределах прикладного типа, к которому оно относится.
А значит мы можем использовать эту особенность, например, для подсчёта количества элементов в справочнике:
Пример 2
Давайте напишем очень глупый запрос, который тем не менее продемонстрирует нам, что в реквизит ЛюбимыйЦвет записывается именно значение реквизита Ссылка элемента, на который он ссылается:
Обратите внимание, как выглядит строковое значение реквизита ЛюбимыйЦвет и Ссылка.
Платформа 1С не вывела нам его настоящее значение (например, 0xA9BA005056C0000811EAA968D227F09C).
Вместо этого она определила, что это значение указывает на элемент справочника "Цвета" с наименованием "Красный" и вывела нам слово "Красный" в качестве представления этого элемента.
Это стандартное поведение платформы, просто так мы никогда и нигде не увидим "сырое" представление реквизита Ссылка.
Пример 3
Наконец, значение поля Ссылка можно использовать для так называемого разыменования через точку для получения значений реквизитов объекта, которому принадлежит поле Ссылка.
К примеру, если мы знаем, что реквизит ЛюбимыйЦвет указывает на элемент справочника Цвета, то мы можем путём разыменования через точку получить любой другой реквизит этого элемента.
Вот пример запроса, в котором мы для каждого элемента справочника Клиенты выводим значение реквизита Код элемента справочника Цвета, на который указывает реквизит ЛюбимыйЦвет.
Код 1C v 8.2 УП
Параметры:
<ИмяПредопределенногоЗначения> (обязательный)
Тип: Строка.
Содержит полный путь до предопределенного значения, включая имя самого значения. Например, "ПланСчетов.Основной.Счет41".
Синтаксис описания предопределенного значения совпадает с синтаксисом оператора ЗНАЧЕНИЕ языка запросов:
<Тип предопределенного значения>.<Имя объекта метаданных>.<Значение>
Тип предопределенного значения> может быть:
Справочник (Catalog);
ПланВидовХарактеристик (ChartOfCharacteristicTypes);
ПланСчетов (ChartOfAccounts);
ПланВидовРасчета (ChartOfCalculationTypes);
Документ (Document) - только пустая ссылка;
Перечисление (Enum);
БизнесПроцесс (BusinessProcess) - только пустая ссылка и получение точек бизнес процесса;
Задача (Task) - только пустая ссылка.
В качестве <Имя объекта метаданных> указывается имя объекта метаданных, как оно задано в конфигураторе.
Для перечислений, определенных в конфигурации, <Значение> указывается как имя соответствующего объекта метаданных типа ЗначениеПеречисления. Для всех остальных типов предопределенных значений <Значение> указывается как имя предопределенного элемента данных, как оно указано в конфигураторе, или ПустаяСсылка для указания пустой ссылки.
Для точек маршрутов бизнес-процессов имя предопределенного значения имеет вид:
БизнесПроцесс.<Имя объекта метаданных>.ТочкаМаршрута.<Имя точки маршрута>
Также метод может быть использован для получения значения системного перечисления. В этом случае параметр формируется как:
<ИмяСистемногоПеречисления>.<ИмяЗначенияСистемногоПеречисления>
Возвращаемое значение:
Тип: Ссылка на объект информационной базы.
Разместил: E_Migachev Версии: | 8.2 УП | Дата: 01.04.2013 Прочитано: 27222
Похожие FAQ
Еще в этой же категории
Как проверить ЭтоНовый() в управляемой форме? 9
Понятие ЭтоНовый() отсутствует в 8.2. Поэтому при необходимости определить, что создается новый элемент можно использовать следующую особенность управляемой формы. Как правило, любая управляемая форма содержит в себе реквизит " Объект" , поэтому Заполнение реквизитов формы и объекта 6
Для реквизитов в документе обработке отчете: Объект.Реквизит = " значение" ; Для реквизитов на форме: ЭтаФорма.Реквизит = " значение" ; Как получить Макет? 6
НаСервере Функция ПолучитьМакетНаСервере(ИмяМакета) ЭтотОбъект=РеквизитФормыВЗначение(" Объект" ); Макет = ЭтотОбъект.ПолучитьМакет(ИмяМакета); Возврат Макет; КонецФункции НаСервере Процедура ВывестиМакет(ТД) Макет = Обработки.ОбработкаВ Как заполнить табличную часть формы программно? 6
Нужно по кнопке Заполнить - сформировать данные для заполнения табличных частей и заполнить их. Форма имеет вид: Рядом с кнопкой Записать и закрыть добавлена кнопка Заполнить документ , код ее команды: // Код заполнения ТЧ НаСервере П Как открыть внешнюю обработку или отчет программно 1С УП? 6
В версии 8.2 и старше: приложение не работает непосредственно с локальными файлами, расположенными на компьютере. Файлы должны находиться на сервере. Поэтому для открытия внешней обработки нужно выполнить следующую последовательность действий: Посмотреть все в категории Управляемое приложение, Тонкий клиент
Здравствуйте.
Вопрос следующий.
мне необходимо получить "Ссылку на документ" в модуле объекта и передать в модуль формы.
Подскажите пжл как это сделать.
Суть следующая:
создал ПечФорму при открытии ПечФормы вызывается модуль формы, в котором производятся некоторые действия.
Т.е. внешняя обработка с видом Печатная форма, подключаемая через ДополнительныеОтчетыИОбработки, с вызовом клиентского метода?
"Ссылка на документ" это ссылка на документ для которого выполняется печать?
Тогда она (они) передаются в функцию Печать.
Вот ОбъектыНазначенияМассив это и есть массив ссылок на документы.
Если вышесказанное не о том, и нужно вызвать модуль объекта обработки из модуля формы, то как-то так:
И для получения ссылки совсем не обязательно вызывать метод модуля объекта. Можно получить и в серверном методе модуля формы. если документ записан то можно ссылку получить и там и там Объект.Ссылка вернет ссылку на текущий документ если он записан, или вам надо получить ссылку другого документа? пробовал я так пишет, что метод объекта не обнаружен если не ошибаюсь когда написано Обьект = Обьект.Ссылка тогда ошибка а если например
Штука(главное изменить название) = Обьект.Ссылка тогда все срабатывает Здравствуйте.
Подключаю дополнительную ПФ через ДополнительныеОтчетыИОбработки,
в модуле объекта след. код:
выскакивает ошибка: " метод объекта не обнаружен"
Пробую и в модуле основной формы и в модуле документа
хочу получить из обработки ссылку на документ, из которого запускается эта обработкат.е. захожу в документ "прием на работу" - печать-ТрудовойДоговор
далее из Функция СведенияОВнешнейОбработке()
вызывается модуль основной формы в котором мне надо получить ссылку на текущий документ "прием на работу" (21) посмотри в интернете урок по созданию ВПФ. Там же можно скачать уже написанную обработку и понять как получается ссылка! хочу получить из обработки ссылку на документ, из которого запускается эта обработка
Особенность использования БСП в том, что обработка запускается не напрямую из документа.
Для внешней печатной формы (ВПФ) вообще использование "ОткрытиеФормы" не нужно. Обычно вполне хватает "ВызовСерверногоМетода".
Далее нужно создать процедуру Печать:
Вот в МассивОбъектов будет массив ссылок на документы для которых нужно печатать.
Пусть переменная СсылкаНаОбъект принадлежит любому ссылочному типу: справочнику, документу, плану счетов и т.д. Получить объект по ссылке можно так:
Пусть переменная Объект принадлежит любому объектному типу. Получить ссылку из объекта можно так:
Будьте внимательны, реквизит “Ссылка” заполняется только при записи объекта. Если объект не записан - ссылки не будет.
Для 8.х НайтиПоСсылкам (FindDataByRef)
Синтаксис:
НайтиПоСсылкам (< Список ссылок> )
Параметры:
<Список ссылок> Обязательный
Тип: Массив. Массив со списком ссылок на объекты, ссылки на которые нужно найти.
Возвращаемое значение:
Тип: ТаблицаЗначений. Таблица значений, состоящая из колонок с индексами: 0 - Искомая ссылка; 1 - Ссылка на объект, который содержит искомую ссылку.
Описание:
Осуществляет поиск ссылок на объекты.
Код 1C v 8.х
Функция НайтиПоСсылке имеет особенность: для корректной её работы необходимо, чтоб все объекты были доступны на чтение. Если у вас есть роли, имеющие ограничение на чтение, то вызов функции НайтиПоСсылке можно выполнять только в привилегированном модуле, иначе может возникать ошибка такого рода:
НайтиПоСсылкам(Ссылки) : Ошибка при вызове метода контекста (НайтиПоСсылкам): У пользователя недостаточно прав на исполнение операции над базой данных.
Для 7-рки - НайтиСсылки
Находит ссылки на объекты, переданные в списке значений.
Синтаксис:
НайтиСсылки(<Объекты>,<Ссылки>)
Англоязычныйсиноним:
FindReferences
Параметры:
<Объекты> Конкретное значение объекта илиобъект типа СписокЗначений, в котором данной процедуре передаются объекты, по которым надо найти ссылки.
<Ссылки> Идентификатор объекта типа ТаблицаЗначений, в который данная процедура помещает найденные ссылки на объекты. Таблица значений состоит из 3 колонок: 1. Объект — объект, на который ссылаются; 2. Ссылка — объект, который содержит ссылку; 3. Комментарий — комментарий кссылке.
Описание:
Процедура НайтиСсылки находит ссылки на переданные в списке объекты, и помещает их в таблицу значений.
Код 1C v 7.x
Разместил: E_Migachev Версии: | 7.x | 8.x | Дата: 05.04.2010 Прочитано: 78991
Похожие FAQ
Еще в этой же категории
Полнотекстовый поиск в 1С (что это и пример использования) 22
Полнотекстовый поиск - позволит найти текстовую информацию, размещенную практически в любом месте используемой конфигурации. При этом искать нужные данные можно либо по всей конфигурации в целом, либо сузив область поиска до нескольких объектов Формат, функция форматирования значений 21
//Функция формирует удобное для чтения представление значений. // Примеры форматирования чисел ЗначФормат = Формат(123456.789, " ЧЦ=10; ЧДЦ=2" ); // ЗначФормат = " 123 456,79" ЗначФормат = Формат(123456.789, " ЧГ=0; ЧДЦ=2" ); // Знач УстановитьСсылкуНового 11
Установить ссылку нового это специальный механизм программиста, который позволяет присваивать новому объекту нужную ссылку. В основном это задача обмена, во многих типовых обменах используется синхронизация по UID объекта. Рассмотрим этот метод на к Обработчики событий при записи объектов. Зачем и что за чем? 11
Программисту, имеющего немного опыта на платформе 1С 8.2, бывает сложно разобраться: ПередЗаписью, ПриЗаписи, ПослеЗаписи, на сервере, на клиенте, в модуле формы, в модуле объекта, а-а-а-а-аааа. Именно такое сложное чувство непонимания МоментВремени, получение остатков до и после проведения 9
" Момент времени" - виртуальное поле, не хранится в базе данных. Содержит объект МоментВремени (который включает в себя дату и ССЫЛКУ НА ДОКУМЕНТ) В 7.7 было понятие ПозицияДокумента, а в 8.x Момент времени Для получения Остатков, Движений: М Посмотреть все в категории Встроенные Функции
Читайте также: