Что такое свойство в 1с программировании
Что такое свойство в 1с программировании
Рассылка
Курс лекций
Статьи
Программы
Ссылки
Конфигуратор
Все начинается с запуска Конфигуратора. Программы для 1С:Предприятие называются «конфигурациями» и создаются они в специальном режиме для разработчика «Конфигуратор». Обычные пользователи работают в режиме «Предприятие».
Объекты, свойства и методы
У объектов имеются некоторые атрибуты (свойства, реквизиты). Например, сотрудник имеет фамилию, имя, отчество, оклад, табельный номер. Приказ о приеме имеет номер и дату. Набор свойств объекта задается разработчиком.
Также объекты имеют определенные методы (процедуры и функции). Например, вы можете выбрать всех сотрудников с помощью метода справочника ВыбратьЭлементы(), или можно сохранить документ методом Записать().
Встроенный язык
Поведение объектов конфигурации задается на встроенном языке. Программист может писать на встроенном языке 1С свои собственные модули, состоящие из процедур и функций. Встроенный язык позволяет работать со справочниками, документами и другими объектами 1С. Можно, например, с помощью методов объектов выбрать все элементы справочника Сотрудники для вывода в отчет, или создать и сохранить любой документ.
Модули, процедуры и функции
Глобальный модуль
В системе 1С есть так называемый Глобальный модуль.Он относится к конфигурации в целом. Глобальный модуль нужен для того, что писать процедуры и функции, доступные в любом месте программы (в любом другом модуле). Для этого необходимо просто указать ключевое слово Экспорт. Также можно создать глобальные переменные, которыми можно будет пользоваться в любом месте программы. Но чем меньше будет таких глобальных переменных, тем лучше, так как модули получаются более независимыми друг от друга, что снижает количество ошибок в программе и облегчает отладку.
Работа со структурами в 1С 8
Структура в языке программирования 1С 8.3 — набор пар «Ключ» и «Значение». Поле «Ключ» имеет строковый тип, «Значение» же может принимать любой тип данных. Обычно используется для хранения и передачи между процедурами набора каких-либо параметров.
Создание новой структуры
Структуру в языке программирования 1С можно создать двумя способами с помощью конструкции «Новый».
Структура = Новый Структура;
Структура.Вставить(«КлючПараметра1», «Значения параметра №1»);
Структура.Вставить(«КлючПараметра2», «Значения параметра №2»);
Структура = Новый Структура(«КлючПараметра1, КлючПараметра2», «Значения параметра №1», «Значения параметра №2»);
Оба способа создадут структуру, которую видно на скриншоте из отладки:
Изменение
Добавить или изменить структуру можно, используя метод «Вставить()».
Если требуется изменить значение старого ключа, вписываем его имя. Если добавить новый ключ, добавить уникальное имя относительно всех ключей структуры.
Чтобы удалить элемент коллекции, нужно воспользоваться методом «Удалить», куда передать имя ключа:
Возможна также очистка всех объектов коллекции:
Обход структуры
Чтобы перебрать коллекцию структуры, нужно использовать конструкцию «Для Каждого КлючИЗначение Из Структура Цикл».
Для Каждого КлючИЗначение Из Структура Цикл
…… //обрабатываем, например, изменяем значения
КонецЦикла;
В каждом цикле будет видно, что нам доступны следующие поля:
Количество элементов в структуре можно подсчитать следующим образом:
Проверка наличия ключа
Часто бывает, что нужно проверить, есть ли в структуре нужное значение по ключу. В таком случае следует использовать метод «Свойство»:
Если в структуре есть элемент с ключом «Контрагент», тогда метод вернет «Истина», в противном случае — «Ложь».
Если Вы начинаете изучать 1С программирование, рекомендуем наш бесплатный курс (не забудьте подписаться на YouTube — регулярно выходят новые видео):
К сожалению, мы физически не можем проконсультировать бесплатно всех желающих, но наша команда будет рада оказать услуги по внедрению и обслуживанию 1С. Более подробно о наших услугах можно узнать на странице Услуги 1С или просто позвоните по телефону +7 (499) 350 29 00. Мы работаем в Москве и области.
Поддержите нас, расскажите друзьям!
СПРОСИТЕ в комментариях!
Есть одна информация, которая не дает мне покоя. В синтаксис-помощнике написано:
Структура (Structure)
()
Использование:
Автор статьи предлагает при изменении существующего ключа структуры использовать метод Вставить. Все, вроде бы, логично и правильно, но тем не менее, если я сделаю так:
Структура.КлючПараметра1=»Другое значение параметра 1″, то 1С-ка проглотит это и не подавится, в то же время как в СП четко написано «ТОЛЬКО ЧТЕНИЕ». Или я чего-то не понимаю?
Структура.КлючПараметра1= «Другое значение параметра 1″
«КлючПараметра1» — это имя ключа (ТОЛЬКО ЧТЕНИЕ)
Значение параметра меняем как хотим 🙂
Ну… так-то если подойти, то да)). Однако, насколько я понял, структура СП в части свойств объекта, который она описывает выглядит так:
Если свойство четко определено — то пишется имя свойства. Например
СправочникСсылка
Наименование
Только чтение
СправочникОбъект
Наименование
Чтение и запись
Если же имя свойства неопределено, оно пишется в тегах «знак больше» и «знак меньше», как в этом случае со свойством «Имя ключа»
И в тех и в других случаях, когда говорится «Только чтение» или «Чтение и запись» — то имеют в виду ЗНАЧЕНИЕ СВОЙСТВА, А НЕ ЕГО ИМЯ.
Например
СправочникОбъект
ИмяОбщегоРеквизита
Чтение и запись (проверьте сами в СП)
здесь же не имеется в виду, что мы можем менять САМО ИМЯ ОБЩЕГО РЕКВИЗИТА. Его-то уж точно нельзя менять. Здесь написано «Чтение и запись» для ЗНАЧЕНИЯ ЭТОГО СВОЙСТВА
Проводя такой же аналог для структуры получаем что речь идет именно о значении свойства, которое указано в имени ключа. Вот в чем прикол-то))
Свойства объектов в 1С
Каждый объект дерева конфигурации имеет набор определенных, а иногда уникальных свойств. Пройдемся по некоторым объектам, опишем их свойства и разберемся, для чего они используются, на примере типовой конфигурации ЕРП 2.4
1. Общие свойства всех объектов 1С
Общие свойства всех объектов 1С в следующем. Каждый объект имеет имя, синоним и комментарий. Имя — уникальное наименование объекта в конфигурации, без пробелов, начинается с буквы. Синоним — произвольное наименование, то, что увидит пользователь в названии объекта в режиме предприятия. Комментарий — описание для разработчиков.
2. Общие модули в 1С
Глобальный — обеспечивает доступность функций данного модуля в любом месте конфигурации, без обращения к самому модулю.
Клиент, сервер — определяет контекст исполнения функций, и откуда их можно вызывать: если установлена галка «Вызов сервера», то данные серверные функции модуля можно вызывать и с клиента. «Внешнее соединение» определяет доступность функций, например для com-соединений 1С.
Привилегированный — все функции в данном модуле будут исполняться под полными правами.
Повторное использование — механизм, позволяющий кешировать результаты функций. Нужен, когда используются функции, часто возвращающие один и тот же результат. В названия таких модулей обычно добавляют ПовтИсп.
3. Регламентные задания в 1С
Имя метода — экспортная процедура общего модуля, выполняемая при срабатывании задания.
Ключ — одновременно может работать только одно задание с уникальным ключом. Сам по себе ключ не уникален, может быть использован для группировки заданий.
Предопределенное — будет ли задание работать сразу же после обновления конфигурации или нужно будет настраивать его запуск вручную в каждой базе.
4. Общие команды в 1С
Тип параметра команды — в каких объектах данная команда будет доступна.
Режим использования параметра — возможность передать в качестве параметра не один, а множество объектов (например, при выделении списка документов).
Изменяет данные — блокирует форму и ставит признак модифицированности в истину.
5. Константы в 1С
История данных — версионирование объекта.
Использовать стандартные команды — видимость константы в командном интерфейсе.
Пояснение — всплывающая подсказка при вызове константы.
Форматы — формат типов число, дата и булево.
Быстрый выбор — отвечает за «выпадание» списка значений при активации поля выбора.
История выбора — «выпадание» недавно выбранных значений.
Связь по типу — установка фильтра значений, доступных для выбора, по отбору, указанному в данном поле.
6. Справочники в 1С:ЕРП 2.4
Иерархический, вид иерархии, количество уровней и их ограничение — определяет наличие групп элементов и их подчинение друг другу, количество уровней вложенности данного подчинения.
Владельцы — если справочник подчинен другому справочнику (например, справочник характеристик номенклатуры подчинен справочнику Номенклатура).
Серии кодов — будут ли коды уникальны во всем справочнике или уникальность будет сохраняться только в пределах одного владельца.
Контроль уникальности и автонумерация — проверка при записи элемента справочника на уникальность его кода и генерация нового кода автоматически.
Обновление предопределенных данных — иногда, например, при использовании РИБ создавать элементы при обновлении в базе не нужно, они загрузятся из основной.
Вводится на основании — можно использовать конструктор для ввода на основании других объектов.
Полнотекстовый поиск — поиск объекта по наименованию по всей базе, с использованием операторов полнотекстового поиска.
Быстрый выбор и способ выбора — выбор элемента из выпадающего списка (удобно, когда мало элементов) и также возможность открытия формы выбора.
Ввод по строке — по наименованиям каких реквизитов будет происходить поиск при вводе символов в поле.
Создание при вводе — появление «плюсика» для создания нового элемента при начале ввода.
7. Документы в 1С
Давайте разберем свойства документов в 1С.
Периодичность — период контроля уникальности номера.
Проведение, оперативное проведение — проводится или только записывается документ, есть возможность проведения оперативно.
Удаление движений — если удалять автоматически, то перед проведением записывается пустой набор записей в регистры.
Запись движений при проведении — можно указать, что в регистры должны записываться только измененные данные.
Заполнения последовательностей — в каких последовательностях участвует документ. Нужно для восстановления правильной цепочки последовательности документов.
Прив. Режимы — действия выполняются на сервере и без контроля прав. Ускоряет проведение документа.
8. Регистры сведений 1С
Периодичность — является ли периодическими, а также с каким периодом вносятся новые записи.
Режим записи — записи вносятся независимо или с помощью документа.
Основной отбор по периоду — если регистр сведения 1С подчинен регистратору, то основной отбор будет по данному регистратору. Если же независимый и периодический, то основной отбор можно установить и на сам период.
Разрешить итоги — создаются дополнительные физические таблицы для хранения итогов, для ускорения доступа к срезу первых и последних.
9. Регистры накопления в 1С 8.3
Давайте рассмотрим регистры накопления в 1С 8.3.
Вид регистра — определяет, создавать ли дополнительную таблицу для хранения остатков по регистру.
Разрешить разделение итогов — включение возможности параллельной записи в регистр данных, разделяемых дополнительным полем Разделитель в таблице регистра. Повышается скорость записи в регистр за счет отсутствия блокировок записей. Чтение же наоборот усложняется за счет необходимости свертки получаемых записей.
10 Регистры бухгалтерии в 1С
Корреспонденция — включает возможность принципа двойной записи за счет наличия корреспондирующих счетов в движениях регистра.
Длина уточнения периода — включает возможность корректировки входящих остатков на границах периодов, разбивая секунду максимум на 1000 интервалов. Число в данном поле указывает количество знаков уточнения периода.
11. Регистры расчета 1С
Период действия — включает доступность реквизитов ПериодДействияНачало и ПериодДействияКонец для расчета периодических начислений (например, оклада по месяцам).
Базовый период действия — включает доступность реквизитов БазовыйПериодНачало и БазовыйПериодКонец для определения границ расчета базы для начислений (например, для начисления суммы больничного используется средняя зарплата за последние три месяца).
График — регистр сведений 1С с данными о периодах, за которые нужно произвести расчеты.
Значение графика — ресурс регистра сведений 1С со значением показателя графика для расчета (например, количество отработанных часов).
Дата графика — измерение, отвечающее за значение периода, в который был отработан данный показатель.
Программирование в 1С для всех
Соответствие в языке программирования 1С чем-то похоже на Структуру, это тоже коллекция пар Ключ и значение. Но в отличие от Структуры, в Соответствие, чтобы получить значение по определенному ключу, нужно обращаться не как к свойству объекта, а через квадратные скобки, и в качестве ключа можно использовать значение любого типа.
Структура: Структура1.Ключ1
Соответствие: Соответствие1[«Ключ1»]
Соответствие можно создать на всех видах клиентов и в любом контексте. Сериализируется, т.е. можно передать переменную с типом соответствие с клиентского контекста на серверный.
Хоть и в ключ и значение соответствия можно записать переменные любого типа, использование типов в этом случае очень сильно зависит от контекста и от вида клиента: мы не можем в клиентском задать в ключ или значение, тип которого работает только в серверном контексте (например, ДокументОбъект.<>).
Новое соответствие создается при помощи конструктора Новый.
Соответствие1 = Новый Соответствие;
Для того, чтобы добавить новый элемент соответствия, необходимо использовать метод Вставить, который имеет следующий синтаксис:
Вставить( , )
Параметр «Ключ» может иметь любой тип! Это очень важное свойство, таким образом, с помощью коллекции Соответствие можно в процессе работы устанавливать соответствие любых объектов с любыми объектами.
Простой пример работы с соответствием:
Для того чтобы поменять значение какого-нибудь элемента, который соответствует определенному ключу, достаточно для этого ключа присвоить новое значение.
Поменять имеющееся значение можно, также используя квадратные скобки.
Обход соответствия 1С
Обходить соответствие можно с помощью цикла Для каждого…Цикл.
Безошибочное получении значения соответствия 1С
Как Вы уже поняли, для того чтобы получить значение элемента соответствия, мы используем квадратные скобки. Но иногда возможны ситуации, когда применение квадратных скобок неосуществимо. В таких случаях мы можем использовать метод Получить, который возвращает любое значение, соответствующее ключу. Если такого ключа нет, то вернется значение Неопределено
Рассмотрим работу данного метода на соответствии с датами в качестве ключей.
Статьи о других универсальных коллекциях значений в 1С
Более подробно о работе с соответствиями и другими интересными объектами языка программирования в 1С читайте в моей книге «Программировать в 1С за 11 шагов»
Изучайте программирование в 1С в месте с моей книги «Программировать в 1С за 11 шагов»
Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.
Промо-код на скидку в 15% — 48PVXHeYu
Если Вам помог этот урок решить какую-нибудь проблему, понравился или оказался полезен, то Вы можете поддержать мой проект, перечислив любую сумму:
можно оплатить вручную:
Яндекс.Деньги — 410012882996301
Web Money — R955262494655
Вступайте в мои группы:
One thought on “ Учимся работать с соответствием в 1С 8.3 ”
В статье упущен важный момент.
Цитирую: «Но в отличие от Структуры, в Соответствие, чтобы получить значение по определенному ключу, нужно обращаться не как к свойству объекта, а через квадратные скобки, и в качестве ключа можно использовать значение любого типа.»
В чем ошибка. Обращение к значению соответствия через [ ] возможно и для структуры: МояСтруктура[«Ключ1»] — тоже можно использовать. Поэтому в отличие от Структуры, чтобы получить значение по определенному ключу, можно обращаться только через квадратные скобки или используя метод «Получить», в то время как в Структуре к значению по определенному ключу можно обратиться еще и по имени свойства через точку.
1С поиск в структуре
Вступайте в мою группу помощник программиста.
В ней мы обсуждаем программирование в 1С.
Структура
Описание:
Представляет собой коллекцию пар КлючИЗначение. При этом ключ может быть только строковым и должен удовлетворять требованиям, предъявляемым к именованию переменных встроенного языка.
К значениям структуры можно обращаться как к свойствам объекта. При этом ключ используется как имя свойства.
Структура используется обычно для хранения небольшого количества значений, каждое из которых имеет некоторое имя.
Элементы коллекции: КлючИЗначение
Для объекта доступен обход коллекции посредством оператора Для каждого … Из … Цикл. При обходе выбираются элементы коллекции.
Структура в языке программирования платформы 1С 8.3 (8.2) — это коллекция некоторых значений в связке с ключом. Эта связка ключа со значением называется «КлючИЗначение». Ключ структуры уникален в рамках данной структуры. Причем к значениям структуры можно обращаться как к свойствам объекта, используя название ключа.
Объект Структура создается с помощью конструктора Новый.
Структура1 = Новый Структура;
Со структурами можно работать и в серверном и клиентском контексте, причем в клиентском контексте с ними можно работать как под толстым клиентом, так и под тонким клиентом.
В значения структуры можно записать переменные любого типа, но использование типов в этом случае очень сильно зависит от контекста и от вида клиента: мы не можем в клиентском контексте задать значение, тип которого работает только в серверном контексте (например, ДокументОбъект.<>).
Как создать новую структуру, Вы знаете, теперь выясним, как создаются новые элементы данного объекта. Делается это с помощь метода Вставить.
Вставить( , );
Параметр Ключ имеет тип значения Строка. Он может иметь любое название, какое захочет разработчик (но помним про ограничения в названиях переменных). Параметр Значение может иметь любой тип.
Обращаю Ваше внимание, что связка «Ключ и значение» уникальна, поэтому если Вы напишете для одной структуры два метода Вставить с одинаковыми ключами и разными значениями, то все равно в структуре будет одна связка «Ключ и значение», причем значение возьмется с последнего метода.
Не всегда обязательно использовать метод Вставить, чтобы добавить пару КлючИЗначение в структуру, иногда это можно сделать в конструкторе. Тогда конструктор будет иметь следующий вид:
Структура1 = Новый Структура(Ключ, Значение);
Переделаем предыдущий пример:
В случаях выше мы не стали думать над названиями ключей, Вы же в процессе работы можете давать ключам любые названия, какие захотите. Главное, чтобы тип ключа был Строка.
В структуру можно записывать не только примитивные типы, но также любые другие объекты «1С:Предприятия», вплоть до других структур. Причем значения типов разных ключей структуры могут быть разными.
Если мы посмотрим в отладке конфигуратора на нашу структуру, то увидим, что она представляет собой некоторый список, где напротив каждого ключа есть то значение, которое мы привязали к данному ключу с помощью метода Вставить. Этот ключ является свойством структуры как объекта, и мы можем обращаться к нему.
Изменить значение ключа структуры 1С
Если нам необходимо изменить значение какого-нибудь ключа, то мы, используя метод Вставить, указываем в качестве первого параметра ключ, значение которого хотим поменять, а в качестве второго параметра новое значение для данного ключа.
Или напрямую обращаемся к ключу
Обход коллекции структуры 1С
Обход структуры осуществляется с помощью оператора цикла Для каждого…Цикл.
Обойдем уже созданную структуру.
Безошибочное получение значения элемента
Если при обращении к ключу структуры Вы укажете название несуществующего в данной структуре ключа, то программа выдаст ошибку. Но есть метод объекта Структура, с помощью которого можно обратиться к значению ключа, не боясь вызвать ошибку в случае промаха.
Этот метод – Свойство.
Данный метод является функцией и возвращает Истину, если указанный ключ есть, и Ложь, если указанного ключа нет.
Рассмотрим синтаксис метода:
«ИмяКлюча» — название ключа для поиска свойства.
В параметр «ЗаписываемоеЗначение» будет возвращено найденное значение. В том случае, если ключа нет в структуре, то данному параметру присвоится значение Неопределено. Обращаю Ваше внимание, что параметр «ЗаписываемоеЗначение» где-то должен быть определен.
В переменную А запишется значение, которое связанно с Ключ1.
Но если мы напишем так.
То ни какой ошибки не возникнет, и в переменной А присвоится значение Неопределено.
Статьи о других универсальных коллекциях значений в 1С
Более подробно о работе со структурой и другими интересными объектами языка программирования в 1С читайте в моей книге «Программировать в 1С за 11 шагов»
Изучайте программирование в 1С в месте с моей книги «Программировать в 1С за 11 шагов»
Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.
Промо-код на скидку в 15% — 48PVXHeYu
Если Вам помог этот урок решить какую-нибудь проблему, понравился или оказался полезен, то Вы можете поддержать мой проект, перечислив любую сумму:
можно оплатить вручную:
Яндекс.Деньги — 410012882996301
Web Money — R955262494655
Структура в языке программирования 1С 8.3 и 8.2 — набор пар «Ключ» и «Значение». Поле «Ключ» имеет строковый тип, «Значение» же может принимать любой тип данных. Обычно используется для хранения и передачи между процедурами набора каких-либо параметров.
Создание новой структуры
Структуру в языке программирования 1С можно создать двумя способами с помощью конструкции «Новый».
Структура = Новый Структура;
Структура.Вставить(«КлючПараметра1», «Значения параметра №1»);
Структура.Вставить(«КлючПараметра2», «Значения параметра №2»);
Структура = Новый Структура(«КлючПараметра1, КлючПараметра2», «Значения параметра №1», «Значения параметра №2»);
Оба способа создадут структуру, которую видно на скриншоте из отладки:
Получите 267 видеоуроков по 1С бесплатно:
Изменение
Добавить или изменить структуру можно, используя метод «Вставить()».
Если требуется изменить значение старого ключа, вписываем его имя. Если добавить новый ключ, добавить уникальное имя относительно всех ключей структуры.
Чтобы удалить элемент коллекции, нужно воспользоваться методом «Удалить», куда передать имя ключа:
Возможна также очистка всех объектов коллекции:
Обход структуры
Чтобы перебрать коллекцию структуры, нужно использовать конструкцию «Для Каждого КлючИЗначение Из Структура Цикл».
Для Каждого КлючИЗначение Из Структура Цикл
…… //обрабатываем, например, изменяем значения
КонецЦикла;
В каждом цикле будет видно, что нам доступны следующие поля:
Количество элементов в структуре можно подсчитать следующим образом:
Проверка наличия ключа
Часто бывает, что нужно проверить, есть ли в структуре нужное значение по ключу. В таком случае следует использовать метод «Свойство»:
Если в структуре есть элемент с ключом «Контрагент», тогда метод вернет «Истина», в противном случае — «Ложь».
Если Вы начинаете изучать 1С программирование, рекомендуем наш бесплатный курс (не забудьте подписаться на YouTube — регулярно выходят новые видео):
К сожалению, мы физически не можем проконсультировать бесплатно всех желающих, но наша команда будет рада оказать услуги по внедрению и обслуживанию 1С. Более подробно о наших услугах можно узнать на странице Услуги 1С или просто позвоните по телефону +7 (499) 350 29 00. Мы работаем в Москве и области.
( голосов, в среднем: из 5)
Поддержите нас, расскажите друзьям!
СПРОСИТЕ в комментариях!
Есть одна информация, которая не дает мне покоя. В синтаксис-помощнике написано:
Структура (Structure)
()
Использование:
Автор статьи предлагает при изменении существующего ключа структуры использовать метод Вставить. Все, вроде бы, логично и правильно, но тем не менее, если я сделаю так:
Структура.КлючПараметра1=»Другое значение параметра 1″, то 1С-ка проглотит это и не подавится, в то же время как в СП четко написано «ТОЛЬКО ЧТЕНИЕ». Или я чего-то не понимаю?
Структура.КлючПараметра1= «Другое значение параметра 1″
«КлючПараметра1» — это имя ключа (ТОЛЬКО ЧТЕНИЕ)
Значение параметра меняем как хотим 🙂
Ну… так-то если подойти, то да)). Однако, насколько я понял, структура СП в части свойств объекта, который она описывает выглядит так:
Если свойство четко определено — то пишется имя свойства. Например
СправочникСсылка
Наименование
Только чтение
СправочникОбъект
Наименование
Чтение и запись
Если же имя свойства неопределено, оно пишется в тегах «знак больше» и «знак меньше», как в этом случае со свойством «Имя ключа»
И в тех и в других случаях, когда говорится «Только чтение» или «Чтение и запись» — то имеют в виду ЗНАЧЕНИЕ СВОЙСТВА, А НЕ ЕГО ИМЯ.
Например
СправочникОбъект
ИмяОбщегоРеквизита
Чтение и запись (проверьте сами в СП)
здесь же не имеется в виду, что мы можем менять САМО ИМЯ ОБЩЕГО РЕКВИЗИТА. Его-то уж точно нельзя менять. Здесь написано «Чтение и запись» для ЗНАЧЕНИЯ ЭТОГО СВОЙСТВА
Проводя такой же аналог для структуры получаем что речь идет именно о значении свойства, которое указано в имени ключа. Вот в чем прикол-то))