на клиенте найти по коду
Получение элемента справочника по коду
Большинство значений субконто при формировании проводок заполняются значениями элементов справочников (контрагентов, материалов и т. д.) Обычно значения элементов справочников выбираются при вводе документа, однако в некоторых случаях возникает необходимость использовать в алгоритмах формирования проводок конкретные элементы справочников, то есть элементы, имеющие определенный код.
В качестве примера рассмотрим алгоритм формирования проводок документом «Списание материалов», создание которого приводится в книге «Введение в конфигурирование 1С Бухгалтерии 7.7»
В этом документе, оформляющем отпуск материалов для вспомогательного производства, формируются проводки по счету 23, на котором ведется аналитический учет в разрезе затрат вспомогательного производства Список затрат вспомогательного производства представляет собой справочник «Затраты»
Приведем фрагмент алгоритма проведения:
В выделенной шрифтом строке алгоритма субконто дебета формируемой проводки заполняется значением реквизита «Затраты» документа «Списание материалов»
Однако может возникнуть ситуация, когда в алгоритме потребуется вместо значения реквизита документа использовать значение заданного элемента справочника. Например, пусть вместо реквизита «Затраты» документа мы всегда будем использовать элемент справочника «Затраты» с кодом «2» То есть в справочнике «Затраты» мы должны найти элемент с кодом «2», получить его значение и присвоить это значение субконто дебета формируемой проводки.
При решении поставленной задачи мы рассмотрим отдельные приемы работы со справочниками, которые используются в алгоритмах документов, а также отчетов и обработок
Для выполнения действий со справочником нам потребуется специальная переменная, мы создадим ее с помощью функции «СоздатьОбъект»
Эта строка должна располагаться выше строк формирования проводок:
Создав объект, имеющий тип обрабатываемого справочника, мы можем приступить к поиску требуемого элемента справочника
Метод «НайтиПоКоду» осуществляет только поиск объекта с указанным кодом. Для получения значения найденного элемента справочника после метода «НайтиПоКоду» обязательно нужно вызвать метод «ТекущийЭлемент».
Полученное значение справочника мы присваиваем субконто дебета проводки
Итак, мы показали, как значению субконто проводки присвоить значение элемента справочника с заданным кодом.
Однако хотелось бы также обратить ваше внимание на то, что не всегда в обрабатываемом справочнике может оказаться элемент с указанным кодом, в этом случае при формировании значения субконто проводки может возникнуть ошибка. Покажем, как эту ситуацию следует корректно обработать.
Спр=СоздатьОбъект(«Справочник.Затраты»); Если Спр.НайтиПоКоду(«2»)=1 Тогда Операция.НоваяПроводка(); Операция.Дебет.Счет=СчетПоКоду(«23»); Операция.Дебет.Затраты=Спр.ТекущийЭлемент(); Операция.Кредит.Счет=СчетПоКоду(«10.1»); Операция.Кредит.Материалы=Материалы; Операция.Кредит.МестаХранения=МестаХранения; Операция.Количество=Количество; Операция.Сумма=Сумма; Иначе Сообщить(«Искомый элемент не найден!»); КонецЕсли;
Как получить реквизит от ссылочного значения на клиенте
На стороне клиента нельзя обратиться к данным базы, в т.ч. получить реквизит от ссылочного значения. Рассмотрим как все же можно решить эту задачу.
На стороне клиента код вида
приведет к ошибке. Такие конструкции возможны только на сервере.
Предположим, что стоит задача при нажатии на кнопку отобразить ИНН контрагента, выбранного на форме. Для решения поставленной задачи необходимо обратиться на сервер для получения требуемой информации(ИНН). Программный код может иметь вид:
Серверная функция является внеконтекстной ( &НаСервереБезКонтекста ). Это значит, что данные, содержащиеся в форме, не будут отсылаться на сервер, что уменьшит объем передаваемых данных и скорость возврата результата функции.
Внимание!
В случае, когда значение реквизита нужно только для визуального отображения пользователю, можно пойти другим путем: имеется возможность вывести реквизит от ссылочного значения на форму. При этом пользователь не сможет отредактировать этот реквизит.
Рассмотрим пример: на форме документа рядом с полем ввода контрагента должен выводиться его ИНН. Для этого перенесем реквизит ИНН на форму:
В пользовательском режиме при указании контрагента, его ИНН будет автоматически отображен на форме. Никакого программирования в этом случае не потребовалось.
Остались вопросы?
Спросите в комментариях к статье.
Отслеживание почтовых отправлений
О сервисе «Единая трекинг-служба»
1Track.ru — это самый удобный и современный сервис для отслеживания посылок и других почтовых отправлений по всему миру. Сервис позволяет максимально просто и быстро отследить все возможные передвижения Вашей посылки.
Больше не нужно проверять посылки на разных сайтах почтовых служб.
Мы сделали поиск всех посылок на одном сайте.
С сервисом «Единая трекинг-служба» отслеживание посылок становится простым и комфортным!
Что такое почтовый идентификатор или трек-код?
Трек-код, по другому почтовый идентификатор или номер отслеживания — это уникальный код, который выдается отправителю посылки и позволяет следить за передвижением своего почтового отправления по стране или всему миру.
Международный трек-код — формат почтового идентификатора утвержденный Всемирным почтовым союзом, и позволяющий следить за посылкой по всему миру.
Выдается обычно при отправке посылки из одной страны в другую.
Всегда состоит из двух латинских символов в начале, которые определяют тип посылки.
Далее девять цифр определяющие номер почтового отправления и в конце две латинские буквы, указывающие на страну отправителя.
Трек-код транспортной, курьерской или логистической компании может представлять из себя любой набор букв и цифр, и соответствует лишь внутренним стандартам каждой отдельно взятой почтовой компании.
Например LP00043154048458, SYBMY09206934, XRU1234567812, 82345679 и так далее.
После экспорта в Вашу страну и прохождения таможни, Ваша посылка получит неотслеживаемый номер.
Отличие номера заказа от трек-номера почтового отправления
При покупке товаров в популярных интернет магазинах вашему заказу автоматически присваивается уникальный трек-номер заказа. Это необходимо для того, чтоб отличать ваш заказ от других заказов магазина.
Почтовые службы и курьерские компании присваивают посылке свой уникальный трек-номер – код отслеживания. Это необходимо для того, чтоб распознать Ваше отправление среди посылок других людей. Отслеживание посылки, как правило, можно произвести только по номеру отслеживания посылки.
Как по номеру отслеживания найти посылку?
Раньше для отслеживания посылки по трек-номеру отслеживания нужно было перейти на сайт компании-отправителя, что очень неудобно. Особенно, если посылка доставлялась сразу несколькими компаниями.
Сейчас Вы можете упростить задачу, для этого просто введите номер своего отправления в строку отслеживания на нашем сайте и находите посылки всех почтовых операторов и курьерских служб.
Почему ваша посылка может перестать отслеживаться?
Чаще всего посылка перестает отслеживаться в силу следующих причин:
Решить проблему можно следующим образом:
Оцените возможности нашего сервиса
Трекинг посылок
Устали ждать посылку? Мы поможем Вам узнать в какой точке мира была замечена Ваша посылка последний раз.
Какая транспортная компания занимается пересылкой Вашей посылки. Без ввода надоедливых символов с картинок.
История посылок
Не хотите каждый раз вводить десятки трек-кодов?
После простейшей регистрации Вы сможете сохранять историю всех своих посылок. Что позволит выбрать в списке нужную посылку, кликнуть по ней и получить актуальную информацию.
Уведомления Email, Push
Хотите быть в курсе изменения статусов?
Расширение для браузера
Установите удобное расширение в браузер Chrome и отслеживайте посылки прямо из личного кабинета на популярных торговых площадках.
А также Вам из расширения всегда доступен обновляемый список всех статусов посылок.
Программирование в 1С для всех
Ссылка указывает на данные экземпляра объекта, но не хранит их, т.е. получив ссылку на конкретный экземпляр объекта, мы сможем узнать всю информацию об экземпляре этого объекта, но не сможем внести какие-нибудь коррективы в эту информацию.
Мы помним, что в платформе 1С 8.3. существуют три вида объектов. Это объекты метаданных, общие объекты и универсальные коллекции значений.
Так вот, ссылка может быть только у объектов метаданных.
Замечу что, ссылка указывает не на сам объект, а на экземпляр объекта. Хотя, очень часто употребляют выражения «ссылка объекта», «ссылка на объект» и т.п.
Ссылку можно использовать в качестве переменной, и также ссылку можно указывать, как реквизит других объектов метаданных.
Например, в моей конфигурации есть справочник Контрагенты.
А также какой-то документ, пусть будет Оплата. И я могу какому-то реквизиту документа Оплата присвоить тип — ссылка на справочник Контрагент.
Это значит, теперь в документе Оплата можно хранить информацию о контрагенте, который сделал оплату.
Если мы используем ссылку в качестве реквизита какого-то объекта, то при редактировании экземпляра, на который указывает ссылка, сам реквизит не изменится.
Поясню на примере. Я выше создал документ Оплата и реквизит Оплативший для этого документа с типом СправочникСсылка.Контрагенты.
Если я переименую элемент справочника Контрагенты.
Затем, зайду обратно в выше созданный документ Оплата, то увижу, что отображение контрагента в реквизите поменялось автоматически.
Что это значит? Это не значит, что реквизит Оплативший элемента и сам элемент справочника Номенклатура поменялся автоматически. Нет, это значит, что данный реквизит хранит указатель на экземпляр объекта, который отображается посредством наименования. Поменяли наименование, поменялось только отображение, если бы поменяли какой-нибудь другой реквизит справочника Контрагенты, то пользователь бы ничего не заметил.
Получить ссылку 1С
Каким образом программно получить ссылку на экземпляр объекта, который уже есть в базе?
Сделать это можно несколькими способами: найти по коду, найти по наименованию, найти по реквизиту и найти по нескольким реквизитам через запрос. Я рассмотрю первые два метода.
Для демонстрации этих методов, на основной форме документа Оплата я создам команду «Установить контрагента», которую размещу в командной панели формы.
При выполнении этой команды я буду в поле Оплативший записывать определенного контрагента. Для этого я создам обработчики команды на клиенте и на сервере.
Первый способ получения ссылки: найти по коду, для поиска по коду необходимо использовать функцию менеджера объекта НайтиПоКоду.
Функция НайтиПоКоду вернёт ссылку на экземпляр объекта справочник Контрагенты, которому соответствует код 000000002. Почему мы задали код в виде строки, а не в виде цифры, например? Чтобы понять это, нужно открыть непосредственно редактор справочника Контрагенты в конфигураторе, перейти на закладку «Данные» и посмотреть, какой тип кода у этого справочника.
Тип кода у справочника Контрагенты — строка, поэтому код мы ищем по строковому значению.
Таким образом, данный код:
возвращает ссылку на справочник Контрагенты, код у которого 000000002. Если такой нет, возвращается пустая ссылка (о них ниже), если с таким кодом несколько элементов, то возвращается один из них, какой конкретно — предугадать невозможно, платформа выберет элемент по своим внутренним идентификаторам.
Рассмотрим синтаксис этой функции для менеджера справочника:
Код – непосредственно тот код, по которому мы ищем наш элемент;
ПоискПоПолномуКоду — если стоит параметр Истина, то поиск будет вестись по кодам всей иерархии, т.е. Вам необходимо будет указывать код каждой группы, куда входит элемент через флеш. Например, так: 001/005/110, где слева будет располагаться самая верхняя группа, а справа непосредственно код элемента.
Данное поле необязательно, по умолчанию – Ложь;
Родитель – для иерархических справочников можно указать группу, тогда поиск будет вестись внутри группы. Данное поле необязательно;
Владелец – для подчиненных справочников можно указать владельца, тогда поиск будет вестись только среди элементов, подчиненных данному владельцу. Данное поле необязательно.
Второй способ получения ссылки: найти по наименованию, для поиска по наименованию необходимо использовать функцию менеджера объекта НайтиПоНаименованию.
Этот способ можно применить только для тех объектов, у которых имеется стандартный реквизит Наименование.
Например, у справочников этот реквизит имеется.
А у документов его нет.
В случае этой функции, поиск ведется по тому значению, которое в поле Наименование объекта
Синтаксис функции для менеджера справочника следующий:
«Наименование» – непосредственно то наименование, по которому мы ищем наш элемент;
«ТочноеСоответствие» — если стоит параметр Ложь, то поиск будет вестись не точно, т.е. когда левая часть наименования элемента и строка поиска будут совпадать (например, Металл и Металл 01), то поиск выдаст результат. Если стоит Истина, то будут найдены только те элементы, наименование которых будет точно совпадать со строкой поиска.
Данное поле необязательно, по умолчанию – Ложь.
Помните это, что по умолчанию поиск ведется не точно;
Параметры «Родитель» и «Владелец» точно такие же, как для процедуры НайтиПоКоду.
Пустая ссылка 1С
У Вас уже, наверное, назрел вопрос: что будут возвращать методы НайтиПоКоду, НайтиПоНаименованию, если такой элемент справочника не был найден. Они будут возвращать Пустую ссылку. Пустая ссылка — это пустое значение какого-нибудь справочника или документа. У менеджеров справочника или документа есть методы, которые возвращают пустую ссылку соответствующих объектов.
ПустаяНоменклатура= Справочники.Номенклатура.ПустаяСсылка();
ПустаяОплата = Документы.Оплата.ПустаяСсылка();
Переменные ПустаяНоменклатура и ПустаяОплата содержат в себе пустые ссылки на каждый объект.
Обращаю Ваше внимание, что для каждого вида справочника и каждого документа будет своя собственная пустая ссылка.
Данный метод очень удобно использовать, когда нам необходимо знать, найден ли элемент справочника по коду (названию) или нет.
Например, доработаем код выше: если элемента с таким названием нет, то выведем сообщение.
ПустаяСсылка() – это метод менеджера объекта. Также есть метод ссылки объекта Пустая(), который возвращает тип булево. Истина — если это пустая ссылка. Код выше можно переделать:
Метод Пустая() удобно использовать работая в клиентском контексте (в том числе на тонком клиенте), потому что менеджер объекта это «тяжелый» объекта и с ним можно работать только в серверном контексте. Т.е. установку контрагента можно сделать таким способом:
В этом коде я получаю по наименованию ссылку на нужного контрагента, делаю это в серверном методе, поскольку обращаюсь к менеджеру справочника, записываю если он не пустой, а потом в клиентском методе проверяю, найден контрагент по такому наименованию или нет, если не найден то вывожу предупреждение.
Более подробно и основательно начальные вопросы программирования в 1С есть вы можете изучить в
Книга «Программировать в 1С за 11 шагов»
Изучайте программирование в 1С в месте с моей книгой «Программировать в 1С за 11 шагов»
Книга написана понятным и простым языком — для новичка.
О том как разрабатывать под управляемым приложением 1С, читайте в книге Книга «Основы разработки в 1С: Такси»
Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.
Промо-код на скидку в 15% — 48PVXHeYu
Эти книги, плюс книга по программированию оперативного учета имеются в едином комплекте: комплект книг по разработке в 1С.
Только для читателей моего блога,
промо-код на скидку в 300 рублей на весь комплект: blog
Если Вам понравился этот урок, был полезен или помог решить какую-нибудь проблему, то Вы можете поддержать мой проект, перечислив любую сумму.
можно оплатить вручную:
Яндекс.Деньги — 410012882996301
Web Money — R955262494655
Программная работа со справочниками в 1С 8.3
Программно можно создавать новые элементы, изменять существующие, удалять, искать элементы по коду, наименованию, реквизитам и т.п. Но нельзя программно добавить новый справочник в конфигурацию. Это выполняется только интерактивно в дереве метаданных.
СправочникиМенеджер
Объект СправочникиМенеджер предназначен для управления всеми справочниками конфигурации. Через цикл можно получить доступ к менеджеру каждого справочника:
Также можно обратиться к менеджеру справочника через точку или через квадратные скобки:
Также через СправочникиМенеджер можно проверить является ли ссылка справочником:
Программное создание элемента справочника
Для программного создания элементов есть метод СоздатьЭлемент. Для программного создания групп — метод СоздатьГруппу:
Программное изменение элементов справочника
Для того чтобы изменить реквизиты уже существующего элемента справочника нужно через ссылку получить объект методом ПолучитьОбъект, через объект изменить значения реквизитов и записать измененный объект в базу данных:
Программное копирование элемента справочника
Методом Скопировать можно создать копию элемента справочника. Данный метод можно вызывать как у ссылки, так и у объекта:
Программное удаление элемента справочника
Для удаления применяются два метода: УстановитьПометкуУдаления и Удалить. Метод УстановитьПометкуУдаления только установит пометку на удаление, сам элемент не будет удален из базы данных. Метод Удалить удалит элемент из базы данных без проверки ссылочной целостности. То есть, если на этот элемент были ссылки в других местах, то теперь вместо ссылки будет надпись «Объект не найден». Не рекомендуется пользоваться методом Удалить. Важно отметить, что вызов метода УстановитьПометкуУдаления вызывает запись объекта. Дополнительно записывать объект не нужно.