Построена простая конфигурация учета движения картриджей для лазерной техники в организации с использованием платформы 1С Предприятие 8.3 и интерфейса "Такси". Учитывается движение каждого картриджа (покупка, заправка, восстановление, ремонт, установка в принтер и пр.) и расход средств по каждому картриджу. Основная цель - освоить разработку приложений на базе платформы 1С Предприятие 8.3 на примере построения работоспособного и полезного приложения.
Я программист со стажем, но 1С серьезно раньше не занимался. Чтобы совместить приятное (знакомство с 1С Предприятие 8.3) с полезным (работу никто не отменял) попробуем построить работоспособную конфигурацию с использованием возможностей новой версии. Может быть процесс разработки конфигурации будет для кого-то полезным и поможет начинающим освоить 1С.
Работаю в отделе IT крупной организации с большим количеством лазерных принтеров и МФУ. Учет движения картриджей для них является актуальной задачей и требованием руководства.
Постановка задачи.
Заправка тонером, восстановление, ремонт картриджей осуществляется сторонней организацией. Необходимо учитывать движение каждого картриджа, то есть покупку, заправку тонером, восстановление, ремонт, установку в конкретный принтер (МФУ), текущее местоположение, списание и пр. Кроме того надо учитывать затраты по каждому картриджу (расходы на покупку, заправку тонером и пр. в разрезе поставщиков).
Понятное дело - нужны какие-то отчеты. Само собой для юзеров все должно быть как можно проще и понятней.
План реализации.
Используем платформу 1С Предприятие 8.3 как самую современную на текущий момент.
Для освоения платформы постараемся использовать как можно больше различных объектов конфигурации и, естественно, новый интерфейс «Такси» . Постараемся давать объектам понятные и близкие к функциональному назначению имена. Не будем пока касаться «тонких» моментов работы 1С, как-то оптимизация клиент-серверного взаимодействия, распределения ролей и пр.
Предположим для начала, что в нашей конфигурации будут следующие объекты:
Справочники:
НоменклатураКартриджей
Картриджи
НоменклатураКартриджейЦены
Принтеры
Номенклатура Принтеров
Поставщики
Документы:
ПоступлениеКартриджей
ЗаменаКартриджа
СписаниеКартриджей
Перечисления:
ДаНет
СостояниеКартриджей
ПричиныЗаменыКартриджей
Регистры сведений:
КартриджиЗамена
Регистры накоплений:
КартриджиОплата
Алгоритм работы.
Основным «действующим лицом» является список имеющихся картриджей (Справочник Картриджи ). Изначально список заполняется документом ПоступлениеКартриджей НоменклатураКартриджей . При покупке картриджа значение реквизит Состояние в документе выбирается как Новый . Цена покупки определяется по справочнику НоменклатураКартриджейЦены натекущую дату СерийныйНомер ). Реквизит Местоположение определяется как «Склад» .
Учет заправок, восстановления, ремонта и пр. существующих уже картриджей осуществляется также документом ПоступлениеКартриджей . Тип картриджей определяется по справочнику НоменклатураКартриджей . Состояние картриджа определяется из перечисления СостояниеКартриджей . Цена работы (заправка, восстановление) определяется по справочнику НоменклатураКартриджейЦены . Уникальность картриджа определяется его серийным номером (реквизит СерийныйНомер ).
При проведении документа ПоступлениеКартриджей в табличную часть ЗаменаКартриджей справочника Картриджи добавляется строка с реквизитами текущего документа и у соответствующих картриджей (с серийным номером из документа) в справочнике Картриджи меняется значение реквизитов Состояние и Местоположение .
Кроме того, в регистрнакоплений КартриджиОплата
Учет замены картриджа в конкретном принтере (справочник Принтеры ) осуществляется документом ЗаменаКартриджа . В документе указывается текущий принтер. Уникальность принтера определяется реквизитом СерийныйНомер . Указывается устанавливаемый и заменяемый картридж (серийные номера картриджей).
При проведении документа ЗаменаКартриджа в табличной части справочника Принтеры у текущего принтера добавляется строка с реквизитами документа и изменяется реквизит Картридж . В справочнике Картриджи у текущих картриджей меняется значение реквизитов Состояние и Местоположение . Для установленного картриджа в реквизите Местоположение прописывается текущий принтер, а у снятого картриджа - «Склад» .
Кроме того, в регистр КартриджиЗамена заносится движение по данному документу.
Списание картриджей осуществляется отдельным документом СписаниеКартриджей .
Таким образом, в текущий момент времени в справочнике Картриджи каждый картридж имеет вполне определенное состояние (новый, заправленный, пустой и пр.) и определенное местоположение («Склад» или конкретный принтер), что путем несложных отчетов позволяет оценить наличие картриджей с заданным состоянием и сделать вывод о необходимости покупки, заправки и пр. Ну и учесть расходы естественно.
Реализация.
Приступим собственно к конфигурированию.
Создадим пустую базу в конфигураторе, назовем ее гордо «Айтишник» и организуем подсистему Учет картриджей . Не буду описывать по шагам, как это сделать, поскольку по данному вопросу книг хватает.
Сначала добавим перечисления: ДаНет , СостояниеКартриджей и ПричиныЗаменыКартриджей , которые нам понадобятся в дальнейшем. Состав перечислений виден на Рис.2
Сконфигурируем простые справочники НоменклатураКартриджей и НоменклатураПринтеров.
Реквизиту ТипКартриджа в справочнике НоменклатураПринтеров присвоим тип ссылка на справочник НоменклатураКартриджей (Рис.3). Не забываем, что все сформированные нами объекты конфигурации надо включить в состав подсистемы УчетКартриджей .
В справочнике Принтеры несколько реквизитов имеют тип ссылки:
Для дальнейшего тестирования программы заполним в режиме Предприятие по нескольку строк в открытых нами справочниках. Естественно, сначала заполняем простые справочники, потом - справочники с реквизитами ссылками. В дальнейшем загрузку полных реальных данных предприятия предполагается осуществить с помощью обработки из таблиц Excel.
Теперь настала пора добавления в конфигурацию документов. Сконфигурируем в дереве объектов конфигурации объект документ ПоступлениеКартриджей с реквизитами и табличной частью НоменклатураДокумента . Регистров накопления у нас в конфигурации пока нет - закладка Движение для документа остается пустой. Поскольку нам надо будет писать свою обработку документа, а пишется программный код в модуле формы документа, то и создадим эту самую форму (Рис.9). Делаем все по умолчанию, как написано в книжках (Форма - Добавить - ФормаДокумента).
Использовать данный документ будем при поступлении на склад как новых, так и заправленных (восстановленных, отремонтированных) картриджей.
Наконец, для учета поступления картриджей заводим регистр накопления КартриджиОплата с измерениями, ресурсами и реквизитами (Рис.10).
В закладке Регистраторы указываем наш документ ПоступлениеКартриджей . Сохраняем конфигурацию.
Возвращаемся по дереву объектов в документ ПоступлениеКартриджей . На закладке Движение выбираем регистр КартриджиОплата , запускаем Конструктор движений и заполняем поле Выражение значениями реквизитов документа (Рис.11).
Жмем ОК и попадаем в Модуль объекта программный код (Рис.12).
Теперь самое интересное - надо добавить в Модуль объекта программный код, для обеспечения следующего функционала при проведении документа ПоступлениеКартриджей .
При поступлении нового картриджа (покупка) в справочнике Картриджи должна добавляться строка с уникальным номером картриджа и соответствующими (из документа) реквизитами. При этом реквизит СостояниеКартриджа будет иметь значение «Новый » , а реквизит Местоположение - значение «Склад ». Табличная часть справочника Картриджи при этом не заполняется.
По алгоритму работы программы изначально надо занести каждый картридж со своим уникальным номером в справочник Картриджи документом ПоступлениеКартриджей.
При поступлении заправленного тонером (восстановленного, отремонтированного и пр.) картриджа считается, что картридж с таким номером уже есть в справочнике Картриджи , и в этом случае при проведении документа ПоступлениеКартриджей, добавляется строкав Табличную частьЗаправки и меняются значения реквизитов Местонахождение и Состояние у текущего картриджа. Добавленный в Модуль объекта код показан на Рис.13.
Теперь можно провести первую пробу работоспособности программы. В Предприятие создаем документ ПоступлениеКартриджей (Рис.14). Нажимаем кнопку Провести и закрыть . Переходим в справочник Картриджи и видим, что в нем появилась строчка с реквизитами купленного картриджа с пустой табличной частью(Рис.15).
Откроем регистр КартриджиОплата (пункт в меню Регистр оплаты картриджей ) и увидим там аналогичную строку.
Создаем и проводим второй документ ПоступлениеКартриджей с тем же картриджем, но заправленным (Рис.16).
Переходим в справочник Картриджи и видим, что у заведенного нами картриджа добавилась строчка в табличной части Заправки и изменился реквизит Состояние (Рис.17).
Ура! Программа работает!
Конечно функциональность документа ПоступлениеКартриджей надо доработать, например, хотелось бы, чтобы автоматически подставлялась последняя по дате цена услуги в поле Стоимость документа из справочника НоменклатураКартриджейЦены при выборе поставщика и для данного типа картриджа.
Это будет позднее, а сейчас займемся заменой картриджей - создадим документ ЗаменаКартриджа и соответствующий регистр сведений КартриджиЗамена .
Реквизиты и табличная часть документа НоменклатураДокумента показаны на Рис.18. Подходящих регистров накопления и сведений у нас в конфигурации пока нет, в закладка Движение для документа не будем ничего отмечать. Поскольку нам надо будет писать свою обработку документа, то создаем ФормуДокумента по умолчанию.
Для учета замены картриджей заводим для разнообразия регистр сведений (не регистр накоплений) КартриджиЗамена с измерениями и реквизитами (Рис.19). Получилось пока без ресурсов как-то.
В закладке Регистраторы указываем наш документ ЗаменаКартриджа .
Сохраняем конфигурацию. Возвращаемся по дереву объектов в документ ЗаменаКартриджа. На закладке Движение выбираем регистр КартриджиЗамена , запускаем Конструктор движений и заполняем поле Выражение значениями реквизитов документа. Жмем ОК и попадаем в Модуль объекта документа, где и видим уже созданный Конструктором движения регистров программный код (Рис.20).
Теперь добавляем в Модуль объекта программный код, для обеспечения следующего функционала при проведении документа ЗаменаКартриджа . В справочнике Принтеры для принтера, у которого заменяется картридж должна добавиться строка в табличной части ЗаменаКартриджей со значениями реквизитов из документа и изменится значение реквизита НомерКартриджаСейчас. В справочнике Картриджи у снятого и установленного картриджей изменятся значения реквизитов Местоположение и Состояние . Доработанная процедура обработки проведения документа ЗаменаКартриджа показана ниже.
Процедура ОбработкаПроведения(Отказ, Режим)
// используемые справочники
Принтеры = Справочники.Принтеры;
Картриджи = Справочники.Картриджи;
// конец вставки используемые справочники
// регистр КартриджиЗамена
Движения.КартриджиЗамена.Записывать = Истина ;
Для Каждого ТекСтрокаНоменклатураДокумента Из НоменклатураДокумента Цикл
Движение = Движения.КартриджиЗамена.Добавить();
Движение.НоменклатураКартриджей = НоменклатураКартриджа;
Движение.СнятКартриджНомер = ТекСтрокаНоменклатураДокумента.СнятКартриджНомер;
Движение.УстановленКартриджНомер=
Движение.МодельПринтера = МодельПринтера;
Движение.ПринтерСерийныйНомер = ТекСтрокаНоменклатураДокумента.ПринтерСерийныйНомер;
Движение.ПринтерИнвентарныйНомер =
Движение.ТипКартриджа = ТекСтрокаНоменклатураДокумента.ТипКартриджа;
Движение.ЗаменаКтоДелал = ЗаменаКтоДелал;
Движение.ПричинаЗамены = ТекСтрокаНоменклатураДокумента.ПричинаЗамены;
// изменяем справочник Принтеры
СтрокаНаименования = ТекСтрокаНоменклатураДокумента.ПринтерСерийныйНомер;
Тогда ТекущийОбъект =
Принтеры.НайтиПоРеквизиту("СерийныйНомер",СтрокаНаименования).ПолучитьОбъект();
ТекущийОбъект.НомерКартриджаСейчас =
ТекСтрокаНоменклатураДокумента.УстановленКартриджНомер;
НоваяСтрока = ТекущийОбъект.ЗаменаКартриджей.Добавить();
НоваяСтрока.ДатаЗамены = Дата;
НоваяСтрока.ВидКартриджа = ТекСтрокаНоменклатураДокумента.ТипКартриджа;
НоваяСтрока.НомерУстановленногоКартриджа =
ТекСтрокаНоменклатураДокумента.УстановленКартриджНомер;
НоваяСтрока.НомерСнятогоКартриджа =
ТекСтрокаНоменклатураДокумента.СнятКартриджНомер;
НоваяСтрока.КтоЗаменил = ЗаменаКтоДелал;
НоваяСтрока.ПричинаЗамены = ТекСтрокаНоменклатураДокумента.ПричинаЗамены;
ТекущийОбъект.Записать();
КонецЕсли;
// изменяем справочник Картриджи - установленный картридж
СтрокаНаименования = ТекСтрокаНоменклатураДокумента.УстановленКартриджНомер;
тогда ТекущийОбъект =
Строка = " ";
Строка = Строка + МодельПринтера + " " +
ТекСтрокаНоменклатураДокумента.ПринтерСерийныйНомер + " " +
ТекСтрокаНоменклатураДокумента.ПринтерИнвентарныйНомер;
ТекущийОбъект.МестоНахождения = Строка;
ТекущийОбъект.Записать();
КонецЕсли;
// снятый картридж
СтрокаНаименования = ТекСтрокаНоменклатураДокумента.СнятКартриджНомер;
Тогда ТекущийОбъект =
Картриджи.НайтиПоРеквизиту("Номер",СтрокаНаименования).ПолучитьОбъект();
ТекущийОбъект.МестоНахождения = "Склад";
ТекущийОбъект.Состояние = Перечисления.СостояниеКартриджа.Пустой;
ТекущийОбъект.Записать();
КонецЕсли;
// конец изменения справочников
КонецЦикла;
КонецПроцедуры;
Для проверки заполняем и проводим документ ЗаменаКартриджа (Рис.21) . Заходимв справочник Принтеры и видим, что у выбранного принтера добавилась строка в табличную часть Заправки с реквизитами проведенного нами документа и реквизит НомерКартриджаСейчас принял значение номера установленного картриджа (Рис.22).
В справочнике Картриджи у картриджа, установленного в принтер, в реквизит Местоположение записались данные текущего принтера (Рис.23) . И кроме того в регистр сведений КартриджиЗамена записалось движение по документу (Рис.24)
Таким образом на данный момент получилась конфигурация по учету движения картриджей для лазерной техники, которую в принципе уже можно использовать в работе.
С точки зрения «идеологии» 1С наверно неправильно изменять реквизиты справочников проведением документов, использовать справочник для хранения текущих цен - тут сказывается предыдущий опыт работы с таблицами автора статьи, а чем справочник не таблица?
Естественно требуется доработка функциональности, добавление отчетов, исправление ошибок и отладка. Об этом в следующей части статьи.
Полная версия статьи приведена в файле Часть1.doc
А.П. Габец, Д.И. Гончаров 1С:Предприятие 8.0 Простые примеры разработки Москва ООО «1С-Паблишинг» 2005 УДК 658.012.011.56:004.42 ББК 65.29 Г12 Габец Андрей Петрович, Гончаров Дмитрий Игоревич Г12 1С:Предприятие 8.0. Простые примеры М.: ООО «1С-Паблишинг», 2005. - 420 с: ил. разработки, ISBN 5-9677-0056-0 Книга представляет собой справочное пособие, иллюстрирующее простые примеры разработки алгоритмов на платформе «1С:Предприятие 8.0». Издание будет полезно начинающим разработчикам, администраторам, у которых на предприятии внедряется система, и продвинутым пользователям, которые хотят самостоятельно дорабатывать прикладные решения. Книга содержит большое количество практических примеров, сгруппированных по тематике использования. Кроме этого книга содержит подробный указатель на используемые в примерах свойства, методы и события встроенного языка. Данная книга дополняет, но не заменяет штатную документацию к программному продукту, входящую в комплект поставки, и позволяет более эффективно использовать возможности программы. Под редакцией М.Г. Радченко. 4601546 025616 ISBN 5-9677-0056-0 Право тиражирования и распространения книги принадлежит фирме "1С-Паблишинг". Полное или частичное копирование материалов книги без письменного разрешения фирмы "1С-Паблишинг" запрещается. ООО "1С-Па6лишингм, 2005 ОГЛАВЛЕНИЕ Введение 16 Как работать с изданием? Примитивные типы, системные функции 17 18 (D Как явно указать нужную дату? Как проверить дату на пустое значение? Как сравнить две даты (дни)? Как прибавить к дате день, месяц? Как можно проверить тип значения переменной на равенство нужному? Как очистить реквизит формы, имеющий ссылочный тип? Как очистить значение, имеющее тип «Хранилище значения»? Как проверить тип значения, помещенного в реквизит имеющий тип «Хранилище значения»? Как сжать данные, помещаемые в хранилище значения? Как предоставить пользователю возможность выбора значения составного типа? Как применить округление при работе с вычисляемыми числовыми полями в запросе? Как вывести многострочное предупреждение? Как при выполнении обработки сообщить пользователю текущее время? Как вывести число прописью по-русски, но без дробной части? Как вывести число прописью по-русски, с указанием сотых в дробной части? Как вывести прописью число килограммов с указанием дробной части в граммах? Как долларовую сумму вывести прописью по-английски? Как загрузить внешнюю компоненту? Как выполнить команду операционной системы? Как реализовать код процедуры в зависимости от режима выполнения (на клиенте, на сервере, во внешнем соединении) ? Как при групповой обработке объектов реализовать стратегию «либо все, либо ничего»? Как посчитать сумму по формуле сложного процента? Универсальные коллекции Массив (D В каких ситуациях обычно используются массивы? ® Как создать массив? ф Как создать многомерный массив? ф Как добавить элементы в массив? 18 18 19 19 20 21 21 21 22 23 24 24 25 25 26 27 27 27 28 29 30 31 32 32 32 32 33 34 Оглавление Ф Как определить размер массива? ф Как обратиться к элементу массива? ® Как перебрать элементы массива? ф Как удалить элемент массива? ф Как удалить все элементы массива? Как удалить повторяющиеся элементы массива? Как скопировать массив? Как проверить, что два массива идентичны? В массив выгружены данные, содержащие наименования контрагентов. Как их отсортировать? Есть массив, в который выгружены значения типа СправочникСсылка.Номенклатура. Как удалить все пустые значения массива? Как получить массив номенклатурных позиций, использованных в табличных частях «Номенклатура» и «Тара» накладной? Есть две таблицы значений. Как получить массив совпадающих имен колонок? Как в запросе сделать отбор по нескольким вариантам заполнения реквизита типа «ПеречислениеСсылка»? Как из регистра сведений «РасчетчикиЗарплатыОрганизации» получить в виде массива всех расчетчиков зарплаты определенного подразделения организации? Структура Ф В каких ситуациях обычно используются объекты типа «Структура»? ф Как создать структуру? ф Как добавить элементы в структуру? Ф Как обратиться к элементу структуры? ф Как перебрать элементы структуры? ф Как удалить элемент структуры? Как в структуре установить значение для элемента с определенным ключом? Как получить в структуру многомерные данные? Как собрать информацию по установленным в форме журнала отборам? Как определить, есть ли в структуре элемент с ключом «Контрагент», и если есть, но содержит пустое значение справочника или Неопределено - удалить этот элемент? Как из табличной части «Товары» документа получить все строки, где значение реквизита «Цена» равно нулю, а значение реквизита «СтавкаНДС» равно значению «НДС 18» перечисления «СтавкиНДС»? Как получить данные о текущей учетной политике бухгалтерского учета организации из периодического регистра сведений на заданную дату? Как сформировать структуру названий реквизитов табличной части произвольного документа? Как получить запросом данные табличной части документа, имея структуру названий реквизитов табличной части? Соответствие 34 34 35 36 37 37 38 39 40 41 42 43 44 45 47 47 47 48 48 49 50 50 51 52 53 53 55 55 57 Оглавление ф В каких ситуациях обычно используются объекты типа «Соответствие»? ф Как создать соответствие? ф Как добавить элементы в соответствие? ф Как обратиться к элементу соответствия? Ф Как перебрать элементы соответствия? ф Как удалить элемент соответствия? Как получить данные из соответствия? Как получить многоуровневое соответствие видов расчетов, обладающих базовыми видами расчетов? 57 57 57 58 58 59 59 60 Список значений, таблица значений, дерево значений 63 ф В каких ситуациях обычно используются списки значений, таблицы значений, дерево значений? ф Как создать список значений? ф Как добавить элементы в список значений? ф Как найти элемент списка значений? ф Как обратиться к элементу списка значений? ф Как перебрать элементы списка значений? ф Как удалить элемент списка значений? ф Как создать таблицу значений и заполнить ее поля? ф Как найти значение в таблице значений? ® Как перебрать строки таблицы значений? ф Как удалить строки (колонки) таблицы значений? Как заполнить таблицу значений, если имена колонок содержатся в переменных? Как заполнить всю колонку таблицы значений нужным значением? Как таблицу значений «ТаблицаПолучатель» заполнить данными таблицы значений «ИсходнаяТаблица»? Как добавить колонки к таблице значений «ТаблицаЗначений» с ограничениями по типу? Как изменить тип значения колонки таблицы значений, полученной выгрузкой из запроса? Как самостоятельно заполнить дерево значений? Прикладные объекты Справочники Ф Как создать элемент (группу) справочника? ф Как найти элемент справочника? ф Как удалить элемент справочника? ф Как перебрать элементы справочника? ф Как выбрать все элементы из определенной группы? Ф Как перебрать элементы подчиненного справочника с помощью запроса? Ф Как перебрать элементы подчиненного справочника с помощью выборки справочника? ф Как открыть форму списка (элемента) справочника? 63 64 64 65 65 66 66 67 68 69 69 71 71 72 74 75 76 78 78 78 80 81 82 83 85 86 86 Оглавление ф Как добавить запись в табличную часть элемента справочника? ф Как удалить строки из табличной части справочника? Ф Как перебрать строки табличной части справочника? Ф Как создать элемент в нужной группе? Как узнать, есть ли у текущего элемента подчиненные? Как узнать количество подчиненных элементов у выбранного элемента справочника? Как узнать количество подчиненных элементов у выбранного элемента справочника, если количество подчиненных справочников больше чем один? Как получить всех родителей выбранного элемента справочника? Как получить запросом «полный» код элементов справочника, если тип кода - Строка? Как получить все элементы справочника, содержащие в наименовании определенную подстроку, со всей иерархией, в которую они входят? Как найти все элементы справочника, в которых не заполнен строковый реквизит? Как перенести все элементы справочника «Контрагенты» из одной группы в другую? Как организовать программный выбор элемента справочника? Как сохранить фотографию сотрудника в справочнике «Сотрудники»? Документы ® Как создать новый документ? ф Как найти документ? Ф Как открыть форму документа? ф Как изменить значение реквизита и записать документ? Ф Как добавить строку в табличную часть документа, имея ссылку на документ? ф Как удалить строки из табличной части документа? ф Как перебрать строки документа? ф Как выгрузить табличную часть документа? ф Как посчитать итог в табличной части документа? ф Как провести документ? ф Как перебрать документы? ф Как пометить на удаление все приходные накладные? ф Как, имея ссылку на документ, создать в базе его копию? ф Как, имея ссылку на документ, прочитать его движения по регистру? Как определить, по каким регистрам документ выполнил движения? Как в табличной части документа удалить строки с нулевым значением реквизита «Количество»? Как очистить колонку «СтавкаНДС» в табличном поле «Товары» уже заполненного документа? Как заполнить значения свойств нового документа на основании существующего? 87 87 88 89 90 91 93 94 96 97 98 99 100 102 104 104 104 105 106 107 107 108 108 108 109 109 111 111 112 113 115 116 117 Оглавление Как получить перечень приходных накладных, в которых не заполнены номенклатурные позиции? Как на дату расходной накладной определить курс валюты управленческого учета? Валюта управленческого учета храниться в периодическом регистре сведений Как из формы документа вызвать его неоперативное проведение? Как в обработке проведения получить остатки, актуальные на позицию документа? Как определить количество документов и количество разных значений реквизита в таблице записей документа? В последовательность «ПартионныйУчет» добавлено измерение «Организация». Как теперь получить данные по границам последовательности для каждого значения этого измерения? Хранение сведений ® Как добавить запись в непериодический независимый регистр сведений? ф Как считать содержимое непериодического независимого регистра сведений? «СобственныеКонтрагенты»? Ф Как удалить все записи из независимого регистра сведений? ф Как удалить записи независимого регистра сведений с отбором по конкретной организации? ф Как добавить запись в периодический независимый регистр сведений? ф Как прочитать (изменить) записи в периодическом независимом регистре сведений? ф Как удалить записи в периодическом независимом регистре сведений? Как в периодическом независимом регистре сведений «КурсыВалют» удалить все записи по валютам с наименованиями «EUR» и «USD», период которых меньше 01 января 2005 года? Как прочитать данные, актуальные на определенную дату, из регистра сведений «Курсы валют» с отбором по нескольким валютам (отбор по измерениям)? Как поменять период у записей периодического независимого регистра, соответствующих ряду условий? Как «сделать периодическим» реквизит уже заполненного справочника? ф Как добавить записи в регистр сведений, подчиненный регистратору? ф Как прочитать (изменить) записи в регистре сведений, подчиненном регистратору? ф Как удалить записи из регистра сведений, подчиненного регистратору? Бухгалтерский учет Ф Как в регистре бухгалтерии сформировать проводки? ф Как получить остаток по счету? ф Как получить обороты по счету? ф Как получить остатки но счетам? 118 119 120 121 122 123 124 124 125 126 126 127 128 128 129 131 132 134 137 138 139 140 140 142 143 143 Оглавление Ф Как перенести остаток со счета на счет? Как найти первый документ, приведший к появлению кредитового остатка на счете? Как выбрать все счета, в аналитике которых присутствуют либо вид субконто «Контрагент», либо вид субконто «Договор»? Как выбрать все счета, в аналитике которых присутствуют как вид субконто «Контрагент», так и вид субконто «Номенклатура»? Как добавить новый вид субконто к счету? Как из регистра бухгалтерии «Хозрасчетный» получить обороты только по валютным счетам? Как выбрать в регистре бухгалтерии «Хозрасчетный» обороты по «60-ым» счетам, исключив внутренние обороты между ними? Как реализовать метод «красного сторно» для регистра бухгалтерии? Сложные периодические расчеты (D Как получить сумму начисления по конкретному виду расчета указанному сотруднику в указанном периоде? (D Как получить сумму всех начислений указанному сотруднику в указанном периоде? Как получить таблицу перерасчетов по перерасчетам нескольких регистров? Как для документа «НачислениеЗарплатыРаботникам» определить номера строк записей полностью вытесненных видов расчета? Как сформировать расчетный листок сотрудника? Как организовать сторнирование уже произведенных расчетов прошлых периодов? Бизнес-процессы Как определить бизнес процесс, в котором количество последовательных этапов определяется индивидуально на момент старта экземпляра процесса? Как при работе с бизнес процессами отказаться от стандартного способа формирования задачи и сформировать ее программно? Прочие прикладные объекты ф Как, не открывая форму внешней обработки, выполнить ее процедуру для определенного объекта? (D Как быстро получить информацию, по всем объектам, находящимся в компетенции конкретного менеджера (элемент справочника «Пользователи») по продажам? Формы и элементы управления Работа с формами (D Как открыть форму документа? Ф Как открыть форму внешней обработки? (D Как отрыть форму отчета так, чтобы она не перекрывала собой ту форму, из которой она открыта? 144 145 146 147 147 149 151 152 154 154 155 156 157 158 159 162 162 167 169 169 169 172 172 172 172 173 Оглавление ® Как открыть форму отчета на весь экран? Как из формы документа открыть форму списка данного документа, спозиционировавшись на нем же? ® В документе есть реквизит «Контрагент». Как открыть форму подчиненного ему справочника «ДоговорыКонтрагентов»? ф Как в форме отобразить картинку, сохраненную в реквизите справочника? ф Как в журнале документов «УчетКадров» отобрать только документы «ПриемНаРаботу»? ф Как узнать интервал дат в открытом текущем журнале? Как при открытии справочника сделать отбор по контрагентам, входящим в список? Как обеспечить, чтобы для выбора значения покупателя в расходной накладной справочник контрагенты открывался сразу с открытой группой «Покупатели»? Табличное поле ф Как запретить пользователю изменять порядок следования колонок в табличном поле? Ф Как запретить пользователю изменять любые настройки колонок табличного поля? ф Как вывести информацию о том, какой отбор установлен в журнале документов? ф Как в форме справочника установить курсор на элемент с известным наименованием? ф Как в форме списка сделать отбор по значению реквизита? ф Как запретить выдачу сообщения: «Введенные данные не отображены в списке, так как не соответствуют отбору» при добавлении новых элементов в справочник? ф Как заполнить ячейку табличного поля данными? Как изменить цвет фона ячейки табличного поля в зависимости от значения, выводимого в нее? Как в табличное поле «ВыбранныеКонтрагенты» добавить новую колонку «ОсновнойДоговор», заполнить ее значения и дать возможность открытия этих значений? Как задать список выбора для колонки «ВидДокумента» табличного поля? Как обеспечить возможность отбора и сортировки данных по реквизитам, не отображаемым в табличном поле формы списка справочника? Как реализовать перетаскивание между элементами управления? Как вывести остатки на складах в списке номенклатуры? Другие элементы управления ® В форме есть панель со страницами. Как разместить картинку на закладке? Ф Как обеспечить, чтобы при открытии формы уже записанного элемента справочника «Контрагенты» активной была закладка «СчетаИДоговоры» панели «Панель»? Как организовать выбор из нескольких списков документов для открытия? Как можно организовать подстановку обращения к персоне? 173 174 175 176 176 177 177 178 181 181 181 182 182 183 184 185 186 187 189 190 190 193 194 194 195 195 197 Оглавление Как в командной панели создать подменю с кнопками? Как созданной кнопке назначить «горячие клавиши»? Как реализовать заполнение возможных значений поля выбора «ОбрабатываемаяТабличнаяЧасть» при заполнении поля ввода «ОбрабатываемыйДокумент»? ф Если пользователь указал несколько дат в поле календаря как их перебрать? ф Как организовать работу с индикатором? Как у элемента управления сменить источник данных? ф Как задать представление даты, отображаемое в поле ввода по-умолчанию? Ф Как вывести текст в поле картинки в том случае, если картинка не выбрана? Ф Как открыть пользователю стандартный диалог выбора цвета? Как заполнить список в форме данными запроса? ф Как отобразить в форме файл графической схемы? Интерфейсы, стили ф Как задать различные стили 1С:Предприятия для различных категорий пользователей? Есть список имен интерфейсов с пометками. Как сделать помеченные интерфейсы видимыми? Как из формы обработки отключить глобальный обработчик ожиданий? Запросы, отчеты Запросы Как получить данные из табличной части документов? Как получить данные из табличной части документов и представить их в иерархическом виде? Как подсчитать количество одинаковых элементов в выбираемых данных? Как применять условия для отбора по значениям полей, вычисленных как результат агрегатной функции? Как ограничить выборку из виртуальной таблицы? Как просуммировать данные по одинаковым значениям одного из полей выборки? Как получить только те записи, в которых значение определенного поля превышает указанное значение? Как обратиться к подчиненным полям в запросе? Как объединить результаты нескольких запросов? Как выбрать данные из двух таблиц, удовлетворяющие определенному условию? Как дополнить данные одной таблицы данными, выбранными из другой таблицы по определенному условию? Как объединить данные из двух таблиц по определенному условию? Как вывести некоторое значение вместо NULL в запросе? 10 198 200 201 202 203 205 206 209 211 212 212 213 213 214 215 216 216 216 217 218 219 220 221 223 224 225 226 227 228 231 Оглавление Как вместе с данными некоторой таблицы получить общие итоги из этой же таблицы? Как получить иерархические итоги по группе справочника? Как по состоянию на заданную дату по регистру «ОстаткиНаСкладе» найти последний документ «ПоступлениеТоваровУслуг», по которому приходила номенклатура? Как подсчитать количество записей с одинаковым значением некоторого поля? Как в итоговых записях вывести количество различных записей? Как узнать количество записей в результате запроса? Как проверить достаточность остатков товаров на складах, указанных в документе? Как в запросе осуществить отбор по значению перечисления? Как получить курсы валют на две интересующие даты? Как одним запросом получить таблицу расхождений курсов взаиморасчетов всех выписанных документов «ЗаказПокупателя» с официальным курсом? Как написать запрос таким образом, чтобы на определенном уровне иерархии запроса считались одни итоговые функции, а на другом уровне другие? Как получить перечень документов, приведших данные подчиненного периодического регистра сведений к определенному состоянию? Как установить параметры запроса, если текст запроса заранее не известен? Анализ данных ф Как получить данные о товарах продаваемых вместе? (D Как порекомендовать сопутствующие товары? (D Как посмотреть, что будет покупаться в дальнейшем? Представление результатов отчетов Табличный документ, текстовый документ Как вывести результат запроса в табличный документ? Как вывести данные в табличный документ с возможностью сворачивания и разворачивания данных по группировкам? Как при выводе данных в табличный документ свернуть все выводимые группировки? Как при выводе данных в табличный документ произвольно определить состав свернутых и развернутых группировок? (D Как выгрузить результат запроса с показом иерархии? (D Где и как можно увидеть макет, автоматически генерируемый построителем отчета? Ф Как из построителя отчета передать данные в сводную таблицу? Отчет формируется построителем отчета. Как убрать одну из колонок, поместив ее данные в расшифровку другой? 231 233 235 237 239 240 240 243 245 246 248 250 252 253 253 254 255 257 257 257 260 260 261 261 262 263 264 11 Оглавление Как сохранить настройки построителя отчета до следующего открытия формы отчета? Как организовать показ примечаний в формируемом табличном документе? ф Как обеспечить, чтобы при вводе на печать не печатались первая колонка и первая строка табличного документа «ДокументРезультат»? Ф Как обеспечить фиксацию верхней части табличного документа, генерируемого построителем отчета, по срезу шапки таблицы? ф Табличный документ формируется построителем отчета. Как при печати табличного документа обеспечить вывод шапки таблицы на каждой странице? ф Как при выводе на печать «длинного» документа указать в колонтитулах страниц номер документа, дату и номер страницы? ® Табличный документ формируется по макету, автоматически генерируемому построителем отчета. Как задать ориентацию страницы при печати? Табличный документ формируется построителем отчета. Как для всех выводимых числовых показателей установить вывод без дробной части? ф Как для построителя отчета совместить назначение своего макета и применение одного из стандартных макетов оформления? Как при получении данных из запроса обойти только итоговые записи? Как при получении данных из запроса обойти только иерархические итоговые записи? ф Как вывести картинку в табличный документ? Как вывести картинку в табличный документ без изменения макета? Как работать со сводной таблицей? Как программно разместить данные в сводной таблице и оформить ее? Как создать печатную форму посредством текстового шаблона? Диаграммы ф Как заполнить диаграмму данными? Как заполнить данными измерительную диаграмму? ф Как вывести результат запроса в сводную диаграмму? ф Как заполнить диаграмму Ганта данными? Как связать интервалы диаграммы Ганта? Как обработать интерактивное изменение интервалов диаграммы Ганта? Как разместить непериодические метки в диаграмме Ганта? Как выделить некоторые интервалы фона диаграммы Ганта? Географическая схема ф Как отобразить в форме файл географической схемы? ф Как отобразить в форме макет географической схемы? ф Как изменить масштаб географической схемы? 12 266 268 271 271 272 273 273 274 276 276 278 279 280 280 282 283 287 287 289 291 293 295 296 298 300 301 301 301 301 Оглавление Как отобразить на географической схеме выбранный город? Как использовать таблицу значений в качестве источника данных географической схемы? Администрирование Запуск 1С:Предприятия из командной строки © Как запустить 1С:Предприятие из командной строки? Как из командной строки заставить 1С:Предприятие сделать выгрузку базы данных? Как из командной строки обновить изменения текущей конфигурации в конфигурации базы данных? Как выполнить тестирование и исправление информационной базы без проверки ссылочной целостности в автоматическом режиме? Как выполнить проверку конфигурации в автоматическом режиме с выводом результатов проверки в файл? Как сократить журнал регистрации программно? Как выгрузить модули прикладного решения в виде текстовых файлов из командной строки? Как загрузить в прикладное решение файлы справки, сохраненные в формате htm? Разное ф Как поменять значение рабочей даты? Ф Как установить/снять монопольный режим? ф Как внести запись в журнал регистрации? ф Как получить данные о зарегистрированных пользователях информационной базы? ф Как определить общую системную информацию? Как программно добавить пользователя в информационную базу? Как создать собственный лог-файл для записи результатов работы внешней обработки? Как в форме отобразить список пользователей, которые работают с данной информационной базой? Как выгрузить журнал регистрации в XML-формате? Как принудительно завершить работу всех пользователей информационной базы в клиент-серверном варианте работы? Интеграция 302 303 305 305 305 306 306 307 307 309 309 310 311 311 311 312 313 314 315 317 318 318 320 321 Текстовый файл 321 XML 324 ф Как выгрузить данные из справочника в текстовый файл? ф Как загрузить данные из текстового файла? Работа с текстом. Модель последовательного доступа ф Как из одной базы перенести документ в другую базу? 321 322 322 324 13 Оглавление Как можно сформировать XML-документ произвольной структуры? Как сформировать XML-документ в строку? Как можно обмениваться данными, используя XMLсериализацию через файлы других форматов? Как можно загрузить XML документ произвольной структуры? 326 327 328 329 DBF-файлы 331 Работа с HTML-документами 332 ф Как можно построить выгрузку-загрузку посредством файлов DBF? Ф Заполнение HTML-анкет Работа с файлами ф Как организовать диалог выбора текстового файла? Ф Как прочитать информацию о файле? ф Как получить список файлов в указанном каталоге? Как переместить файл, выложенный на ftp к себе на локальный компьютер? Как разделить большой файл на несколько файлов определенного размера? Как поместить файлы в архив? Как сравнить два текстовых файла? Как организовать контроль формирования файла внешним приложением? ActiveX Ф Как использовать элементы управления ActiveX? 331 332 335 335 336 336 337 337 338 338 340 341 341 Макеты Active Document 343 Работа с Интернет 345 Работа с СОМ-объектами 351 Как сформировать новый договор на основании файла Microsoft Word? 343 Работа с электронной почтой 345 Как организовать работу с электронной почтой через установленного почтового клиента? 345 Как организовать работу с почтой без установленного почтового клиента на компьютере пользователя? 346 Работа с файлами 349 Загрузка файлов по FTP 349 Выполнение HTTP запроса 350 ф Как из одной базы 1С:Предприятие 8.0 перенести остатки товаров в другую базу, используя СОМ-соединение Пример обращения к программе 1С:Предприятие 8.0 из модуля MS Excel через СОМ-соединение ф Как организовать считывание данных из файлов *.xls? Как запустить макрос, записанный в книге Microsoft Excel? Как создать документ программы Microsoft Excel no оформлению, приведенному в другом документе? ф Как выгрузить прайс-лист в документ программы Microsoft Word? 14 351 353 355 356 357 359 Оглавление ф Как выполнить запрос к произвольной базе данных SQL? Automation Client/Server (OLE) ф Как из одной базы 1С:Предприятие 8.0 интерактивно заполнить документ в другой базе, используя Automation Client/Server (OLE)? Как из таблицы Excel загрузить список номенклатуры в 1С:Предприятие с возможностью редактирования? Обмен данными <Э Как организовать работу удаленных складов? Как при создании начального образа управлять тем, какие виды объектов перегружаются, а какие нет? Как просмотреть объекты, для которых зарегистрированы изменения? Как организовать обмен данными между произвольными конфигурациями 1С:Предприятие 8.0? Как принудительно зарегистрировать изменения объектов? WEB-расширение ф Как в форме списка номенклатуры отменить все установленные отборы? Как запретить перенос содержимого ячеек в форме списка расходных накладных? Как открыть список расходных накладных с отбором, установленным по определенному складу? Как добавить кнопку для ввода документа на основании? Указатель 362 363 363 364 366 366 369 371 372 379 380 380 382 384 388 389 15 Введение Идея написать эту книгу возникла у нас не случайно. Платформа системы «1С: Предприятие 8.0» специально ориентирована на то, что ее будут использовать не только как средство разработки, но и как инструмент быстрой доработки «на месте». В таких случаях специалисту важно в сжатые сроки решить конкретную задачу без долгого изучения всех возможностей системы. Как преподаватели учебного центра - мы, разумеется, только за то, чтобы специалист был изначально методологически и всесторонне «подкован». Но как практикующие разработчики, кроме всего прочего, зачастую и сами с большей радостью используем описанные примеры решения тех или иных задач, нежели пытаемся воссоздать их по памяти или по методическим материалам. Собственно говоря, именно с целью помочь в подобных ситуациях, и была написана эта книга. Основой ее создания послужил опыт преподавания «программистских курсов» по системе, работа на конкретных внедрениях и активное общение в форумах, посвященных данному кругу проблем. Фактически книга составлена в результате анализа того, какие задачи приходится решать чаще всего как начинающим, так и продвинутым разработчикам. При подборе примеров мы исходили из того, что спектр навыков и знаний специалистов, которые будут работать с данным изданием, может быть очень широк. Поэтому пусть Вас не смущают некоторые особо «бородатые» советы или, наоборот, - отсутствие подробного описания тех или иных технологий. А для тех, кто практически не знаком с системой «1С:Предприятие 8.0», материал самых простых примеров, объясняющих азы использования объектов и механизмов системы, помечен специальным значком ф. Кроме этого, поскольку работа с настоящим изданием не требует досконального чтения всего материала, по тексту намеренно вставлены повторы некоторых приемов или предостережений в тех случаях, когда это имеет смысл. Также следует заметить, что мы стремились сделать именно сборник простых примеров, поэтому некоторые материалы вошли в издание в «разрезанном» виде. То есть вместо сложных и громоздких «сквозных» примеров, мы старались представить отдельные части, «кирпичики», из которых впоследствии можно собрать желаемое. 16 Введение Стиль изложения соответствует цели издания, поэтому материал предоставляется в форме вопросов и ответов, как, например, в следующем разделе: Как работать с изданием? Решение данного вопроса - многовариантно. Можно читать классическим способом. От начала до конца, помечая или закладывая понравившиеся места. Впоследствии, при возникновении конкретных вопросов, зрительная память или закладки помогут найти нужное решение. Можно читать выборочно. Любимая поговорка крутых программистов: «Мануал открывать надо уже в последний момент». То есть, проблема возникла - нашли раздел и попытались найти решение, или идею решения по аналогии. Но поговорку, на самом деле, мы совсем не одобряем! Можно вообще не читать. Не читать комментарии. А рассматривать издание как сборник «шпаргалок» кода, решающего те или иные вопросы. Остальные варианты использования издания или не очень нравятся авторам, или достаточно опасны. Например, не надо рассматривать эту книжку как замену полноценного обучения или работы с методическими материалами. 17 Примитивные типы, системные функции Как явно указать нужную дату? Для указания нужной даты можно пользоваться: литералом вида ТГГГММДДччммсс" встроенного языка; встроенной функцией преобразования значений Дата(); литералом типа Дата языка запросов. В таблице ниже приводится ряд возможностей явного указания даты при помощи встроенного языка: Выражение "20050308" Дата(2005, 1,1) Дата(1, 1, 1) Дата(2005, 1, 1, 10, 29, 50) Значение результата (тип) 08.03.2005 0:00:00 (Дата) 01.01.2005 0:00:00 (Дата) 01.01.0001 0:00:00 (Дата) 01.01.2005 10:29:50 (Дата) В случае же, если в тексте запроса необходимо жестко указать некую дату - используется литерал ДАТАВРЕМЯ(). Например, поле со значением "01.01.2005 0:00:00" можно получить так: Как проверить дату на пустое значение? Значение типа Дата не бывает «пустым». Если в явном виде значение переменной типа Дата не задано, она будет иметь значение по умолчанию: начало первого дня первого месяца первого года (00 часов 00 минут 00 секунд). Поэтому проверку проще сделать так: 18 Примитивные типы, системные функции Как сравнить две даты (дни)? Точность данных типа Дата - до секунды. А сравнивать нужно именно дни. Тогда проще предварительно для сравниваемых дат воспользоваться функцией, которая возвращает, например, дату начала дня. А потом уже сравнивать полученные значения. Как прибавить к дате день, месяц? Так как тип Дата содержит дату и время с точностью до секунды, то для того чтобы к некоторой дате прибавить один день, нужно увеличить ее значение на количество секунд, содержащихся в одном дне: Для увеличения или уменьшения даты на некоторое количество месяцев, можно использовать: функции работы со значением типа Дата во встроенном языке; функции работы со значением типа Дата в запросах. В таблице ниже приводится ряд возможностей использования функций встроенного языка: Выражение ДобавитьМесяц(Дата(2005, 1, 31), 1) ДобавитьМесяц(Дата(2005, 2, 28), -1) КонецМесяца(ДобавитьМесяц(Дата(2005, 2, 28), -1)) Значение результата (тип) 28.02.2005 0:00:00 (Дата) 28.01.2005 0:00:00 (Дата) 31.01.2005 23:59:59 (Дата) 19 Примитивные типы, системные функции А вот пример функции, добавляющей количество дней к исходной дате при помощи запроса: В тексте запроса используем функцию ДОБАВИТЬКДАТЕ(). В качестве параметров ей необходимо передать исходную дату, тип добавляемых периодов (в нашем случае жестко прописали «День») и количество добавляемых периодов. Первый и последний параметры передали запросу, считав их из параметров (заголовка) нашей функции. Далее запрос выполняется, и из него получаем значение выходного поля по первой (и единственной) строке. Результаты выполнения вышеприведенной функции будут такими: ПолучитьДень("20052802", 10) = 10.03.2005 0:00:00 ПолучитьДень("20042802", 10) - 09.03.2004 0:00:00, поскольку 2004 год был високосным! Как можно проверить тип значения переменной на равенство нужному? 20 Примитивные типы, системные функции ТипЗнч() - функция языка, возвращающая по значению его тип. Тип () - функция языка, возвращающая значение типа Тип по строковому имени типа. Как очистить реквизит формы, имеющий ссылочный тип? К примеру, реквизит (имя «Товар») имеет тип СправочникСсылка.Номенклатура. Для очистки значения в связанном с ним элементе управления на форме, необходимо выполнить строку кода: То есть необходимо установить значение по умолчанию. А им, в данном случае, будет пустая ссылка на элемент справочника «Номенклатура». Как очистить значение, имеющее тип «Хранилище значения»? Очистить значение, записанное в реквизит или ресурс «РеквизитХранилище») можно следующим образом: (имя Как проверить тип значения, помещенного в реквизит имеющий тип «Хранилище значения»? По причинам не связанным с возможностями системы 1С:Предприятие 8.0, в реквизит «Фотография» (тип ХранилищеЗначения) справочника «Сотрудники» помещалась либо Строка (преобразованная к типу ХранилищеЗначения), либо Картинка (преобразованная к типу ХранилищеЗначения). Как проверить, что было записано? 21 Примитивные типы, системные функции Проверку можно осуществить, используя следующие строки кода: Следует отметить, что в реквизит имеющий тип ХранилищеЗначения можно поместить только значение, имеющее тип ХранилищеЗначения. Работа со значением, помещенным в хранилище значения, может начаться только после его получения (метод Получить()). После получения значение «восстанавливает свой прежний тип». Если полученное значение равно Неопределено, то это означает, что никакое значение в реквизит не записывалось. Как сжать данные, помещаемые в хранилище значения? Допустим, в реквизит «СопроводительнаяИнформация» (тип значения - Хранилище значения) помещается значение переменной «ПомещаемоеЗначение». Нужно обеспечить максимальное сжатие данных закладываемого значения. Вторым параметром конструктора хранилища значения передается объект СжатиеДанных. Он тоже получен соответствующим конструктором, с указанием максимального уровня сжатия. 22 Примитивные типы, системные функции Как предоставить пользователю возможность выбора значения составного типа? Для реализации этой задачи необходимо воспользоваться конструктором объекта ОписаниеТипов. А для него необходимо передавать в качестве параметра массив разрешенных для вводимого значения типов значения. Когда конструктором «ОписаниеВозможныхТипов» собрано применяем функцию для вызова диалога ввода данных ВвестиЗначение(). Первым параметром функции необходимо указать доступную в данном модуле переменную для принятия введенного значения. Вторым - заголовок открываемого окна. Третьим - объект ОписаниеТипов. После ввода значения пользователем можно считать значение с переменной, переданной первым параметром. 23 Примитивные типы, системные функции Как применить округление при работе с вычисляемыми числовыми полями в запросе? Например, составляется запрос для оценок средней цены продажи по данным регистра «Продажи». Для получения данных с точностью до двух знаков после запятой текст запроса может выглядеть следующим образом: Источником для запроса является виртуальная таблица «РегистрНакопления.Продажи.Обороты», построенная по данным регистра в интервале между «ДатаНач» и «ДатаКон». В качестве выходных полей берем «Номенклатура» и результат деления значения полей источника «СтоимостьОборот» и «КоличествоОборот». Причем оператором ВЫРАЗИТЬ() тип последнего поля приводится к примитивному типу ЧИСЛО с определенным форматом (длинна 15, точность 2). Как вывести многострочное предупреждение? Переменные «Остаток» и «Зарезервировано» содержат значения, которые необходимо вывести в виде предупреждения. Кроме того, нужно еще вывести свободный остаток, вычисляемый по формуле: СвободныйОстаток = Остаток - Зарезервировано. Все это может быть выполнено следующим образом: 24 Примитивные типы, системные функции Процедура глобального контекста Предупреждение() выводит на экран модальное окно предупреждения. Текст предупреждения передается первым параметром, вторым - таймаут, содержащий указание количества секунд, через которое окно самостоятельно закроется (если раньше его не закроет пользователь), третьим - указывается заголовок окна. Многострочность предупреждения в нашем примере осуществляется за счет добавления значения ПС (перевод строки) системного набора значений СИМВОЛЫ в текст предупреждения. Обратите внимание на вычисление свободного остатка в скобках для обеспечения корректности выполнения арифметических действий и преобразования данных к типу Строка. Кроме того, хотелось бы предупредить об опасности попыток применения процедуры Предупреждение() в ходе проведения документов. Проведение документов выполняется в транзакции, поэтому использование каких либо интерфейсных решений, останавливающих работу системы, является совершенно неприемлемым. В подобных случаях лучше информировать пользователей посредством Сообщить(). Как при выполнении обработки сообщить пользователю текущее время? Метод ТекущаяДата() возвращает системную дату. Тип значения Дата. В его значение входит и дата и время. Для получения представления только времени можно применяем функцию Формат(). Как вывести число прописью по-русски, но без дробной части? Для этого используется функция ЧислоПрописью(). У нее могут быть указаны в качестве параметров: преобразуемое число; форматная строка; параметры предмета исчисления (вид этой форматной строки определяется значением кода локализации). 25 Примитивные типы, системные функции Все возможные варианты локализаций описаны в файле Locllnfo.txt, входящем в комплект поставки программы. Для решения нашей задачи можно использовать следующий текст: В форматной строке указываем код локализации - Русский(Россия). В параметрах предмета исчисления показываем, что дробная часть не должна содержать ни одного разряда. Для ВыводимоеЧисло = 234,4 результат будет: «Двести тридцать четыре». Как вывести число прописью по-русски, с указанием сотых в дробной части? В параметрах предмета исчисления указываем возможные спряжения и склонения слов «целая» и «сотая», а так же количество разрядов дробной части, которые будут выводиться прописью. В форматной строке указываются код языка локализации и необходимость вывода дробной части прописью. Для ВыводимоеЧисло - 123,45 результат будет: «Сто двадцать три целых сорок пять сотых». 26 Примитивные типы, системные функции Как вывести прописью число килограммов с указанием дробной части в граммах? В отличие от вышеприведенного примера здесь предметами исчисления являются килограммы и граммы, а количество разрядов дробной части - три. Для ВыводимоеЧисло = 12,345 результат будет: «Двенадцать килограммов триста сорок пять граммов» Как долларовую сумму вывести прописью поанглийски? Для ВыводимоеЧисло = 1 232,45 результат будет: «One thousand two hundreds thirty two dollars 45 cents» Какзагрузитьвнешнююкомпоненту? Загрузим компоненту, позволяющую работать со сканером штрихкодов: 27 Примитивные типы, системные функции В случае ошибки загрузки компоненты или создания объекта возникает исключительная ситуация, которую рекомендуется отрабатывать с помощью конструкции Попытка. Как выполнить команду операционной системы? К примеру, требуется удалить все файлы из указанного каталога. Для реализации данной возможности достаточно выполнить следующую строку кода: Для просмотра доступных команд можно в командной строке системы выполнить команду «help». Вызвать командную строку, можно выполнив строку кода: Кроме этого, для запуска внешнего приложения (или открытия файла с использованием ассоциированного с ним приложения) может быть использован метод глобального контекста ЗапуститьПриложение(). В этом случае запуск приложения будет осуществляться непосредственно, минуя командный интерпретатор. Например: 28 Примитивные типы, системные функции Как реализовать код процедуры в зависимости от режима выполнения (на клиенте, на сервере, во внешнем соединении) ? Если алгоритм должен выполняться по-разному в зависимости от места выполнения процедуры, то можно воспользоваться инструкциями препроцессора: 29 Примитивные типы, системные функции Как при групповой обработке объектов реализовать стратегию «либо все, либо ничего»? Требуется загрузить либо все данные по справочнику «Единицы измерения», либо, в случае возникновения ошибки, нужно чтобы ни один элемент не был записан. Для реализации стратегии «либо все, либо ничего» можно использовать следующий фрагмент кода: Если необходимо но мере накопления каких-либо признаков «искусственно» отменить действия, совершаемые в транзакции, можно использовать метод системы: МО Примитивные типы, системные функции Как посчитать сумму по формуле сложного процента? Возведение в степень реализуется функцией Pow(). Первым параметром передается основание степени, вторым - показатель степени. Замечание: кроме работы со степенями математический аппарат системы позволяет работать с корнями, логарифмами и тригонометрическими функциями. 31 Универсальные коллекции Массив В каких ситуациях обычно используются массивы? Массив является универсальной коллекцией, то есть объектом, предназначенным для работы с временными наборами данных в течение сеанса работы пользователя. Необходимость в его использовании возникает, когда требуется работать с временным набором данных. Чаще всего это промежуточные операции обработки информации: подготовка отборов, реализация поиска, подготовка группирования, передача параметров и проч. Массивы могут создаваться оператором Новый или получаться в результате применения методов некоторых объектов. Как создать массив? Создание массивов чаще всего происходит посредством оператора Новый: где «СозданныйМассив» - имя переменной, которая будет содержать созданный объект типа Массив. После создания к массиву можно добавлять элементы (произвольное количество). Если же мы хотим создать массив с заранее определенной размерностью, это можно сделать так: В результате в переменной «СозданныйМассив» будет создан массив с десятью значениями. Для такого массива можно потом сразу обращаться к любому из десяти значений (начиная с нулевого по девятое) для записи или для чтения. А при необходимости к такому массиву можно так же еще добавлять новые элементы. Первый же добавленный элемент получит индекс «10». 32 Массив Как создать многомерный массив? Массив является линейной динамической коллекцией с произвольным типом значений. Поэтому значениями массива могут выступать другие массивы. То есть создание массива массивов и решает задачу создания многомерного массива. Это можно делать при использовании конструктора массива: или в процессе добавления очередных элементов к массиву: И в том и в другом случае мы решим задачу создания двумерного массива размерностью 2x8. Чтение и запись значений такого массива можно производить посредством директивного указания индексов: или при помощи метода Получить(): Хотелось бы еще раз отметить, что создание массива определенной размерности конструктором ограничивает только количество возможных к заполнению значений массива, но не препятствует добавлению новых значений (в качестве которых могут выступать массивы произвольной размерности). 33 Универсальные коллекции Как добавить элементы в массив? Допустим, массив, к которому нужно добавить значение из переменной «НовоеЗначение», называется «НашМассив». Если нужно просто добавить очередной элемент (с индексом на единицу больше самого старшего) - действуем следующим образом: Если нужно, чтобы новые значения добавлялись с определенным индексом, то можно использовать метод Вставить(): Как определить размер массива? Чтобы определить можно сделать так: количество элементов массива «НашМассив» Однако имейте в виду, поскольку индексация элементов массива начинается с нуля - значение переменной «Размер» будет на единицу больше значения самого старшего индекса. Как обратиться к элементу массива? При обращении как для записи, так и для чтения элементов массива лучше пользоваться оператором , указывая индекс элемента. Помните, что индексация начинается с нуля. Пусть в переменную «ПервоеЗначение» нужно считать значение самого первого элемента массива, а в элемент массива с индексом «9» записать значение из переменной «ДесятоеЗначение»: 34 Массив Аналогичных результатов можно добиться при помощи методов Получить() и Установить(): Замечание: в любом случае, чтобы иметь возможность обратиться к элементу массива, он должен уже существовать. Иначе получим ошибку с сообщением о том, что индекс находится за границами массива. Как перебрать элементы массива? Если перебор элементов массива нужен для чтения данных из массива - проще всего организовывать посредством цикла перебора коллекции. Например, чтобы вывести сообщения о каждом числе, найденном в массиве «МассивЭлементов», достаточно сделать следующее: Обратите внимание, «ЭлементМассива» - это произвольное имя переменной, принимающей в себя очередное значение элемента коллекции при выполнении цикла. Если же при переборе элементов массива нужно их редактировать, то для этого нужно работать еще и с индексами элементов. Лучше тогда использовать так называемый «цикл-счетчик». Например, чтобы обнулить все числовые элементы массива, достаточно сделать следующее: 35 Универсальные коллекции «Сч» - это переменная, принимающее очередное значение счетчика на каждом выполнении цикла. Именно из нее и будем считывать значение индекса очередного элемента массива. Значение самого большого индекса массива определяется посредством метода ВГраница(). Как удалить элемент массива? Удаление отдельных элементов массива происходит с обязательным указанием индекса удаляемого элемента. Так, например, будет удален первый элемент массива: Естественно, если указанный индекс будет выходить за границы массива - получим сообщение об ошибке. Кроме того, необходимо учитывать, что удаление элемента «из середины» массива приведет к уменьшению на единицу индексов элементов, стоявших «после» удаленного. Массив как бы «сомкнет ряды». Поэтому, например, один из наиболее простых вариантов удаления всех числовых элементов массива может выглядеть так: Сначала определяем самый старший индекс элементов массива. Цикл проверок и удалений чисел будет выполняться, пока очередное значение индекса не окажется меньше нуля. В цикле определяем тип значения элемента с текущим индексом. Если это число - удаляем данный элемент. Кроме того, в любом случае уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор элементов массива проводится с конца, эффект «смыкания рядов» будет производиться только для уже проверенных элементов. 36 Массив ® Как удалить все элементы массива? Если требуется полное удаление элементов из массива, операция выполняется гораздо проще: Как удалить повторяющиеся элементы массива? Поскольку объект «массив» является одной из самых простых универсальных коллекций, методами поиска по значению он не обладает. Поэтому для того, чтобы удалить повторяющиеся элементы, следует перебрать все элементы массива и проверить их значения. Для выполнения поставленной задачи организуется два цикла: в первом цикле осуществляется перебор элементов массива и для каждого выбранного элемента осуществляется вложенный цикл сравнения 37 Универсальные коллекции текущего элемента с последующими элементами массива. В случае совпадения значений последующий элемент массива удаляется. Когда для очередного элемента с индексом «ТекущийИндекс» завершился вложенный цикл проверки с последующими - увеличиваем значение «ТекущийИндекс» на единицу с тем, чтобы следующий по индексу элемент попал в положение проверяемого. Как скопировать массив? Для получения копии массива в другом объекте (массиве) необходимо создать новый массив (массив-копию) конструктором. Далее в цикле перебора элементов исходного массива добавлять эти элементы в массив-копию. Массив Как проверить, что два массива идентичны? Это можно выполнить при помощи следующей функции. В качестве параметров ей передаются сами проверяемые массивы «ПервыйМассив» и «ВторойМассив». Сначала проверяем совпадение наибольших индексов в массивах, если совпадения нет - массивы уже не идентичны. Значит функция возвращает значение ЛОЖЬ. Далее необходимо произвести проверку идентичности элементов массивов с одинаковыми индексами. Поскольку индексация элементов массива начинается с нулевого значения - выполняем цикл-счетчик от нуля до значения наибольшего индекса массива. Внутри цикла при выполнении неравенства очередных элементов функция возвращает значение Ложь. Если цикл пройден до конца - значения всех элементов с одинаковыми индексами совпали. Значит функция может вернуть значение Истина. 39 Универсальные коллекции В массив выгружены данные, содержащие наименования контрагентов. Как их отсортировать? Список значений позволяет выполнять сортировки по представлению или по значению и, кроме того, обладает возможностями загрузки данных из массива и выгрузки в массив. Поэтому один из вариантов решения данной задачи может быть таким: Создаем список значений. Загружаем значения из массива «МассивНаименований». Сортируем список значений по значениям. Поскольку параметр не указали, направление сортировки будет - по возрастанию. Если нужно по убыванию - в качестве параметра надо передать соответствующее значение системного перечисления НаправлениеСорТИрОВКИ: После выполнения сортировки выгружаем значения из списка значений в массив. 40 Массив Есть массив, в который выгружены значения типа СправочникСсылка.Номенклатура. Как удалить все пустые значения массива? Получаем в виде параметра процедуры массив номенклатурных позиций. Устанавливаем нулевое значение счетчика - переменной «Счетчик». Организуем цикл, который будет выполняться, пока значение переменной «Счетчик» меньше количества элементов массива. Поскольку индексы элементов массива начинаются с нулевого значения, то наш цикл прервется в момент, когда значения индекса («Счетчик») и количества элементов совпадут. Внутри цикла проверяется условие, является ли ссылка, содержащаяся в очередном элементе массива - пустой. Если это так текущий элемент массива удаляется. В результате у следующих за ним элементов автоматически на единицу уменьшаться индексы. Кроме того, необходимо уменьшить на единицу значение переменной, отслеживающей количество элементов в массиве. Если же ссылка не пустая - увеличивается на единицу значение «Счетчик» с тем, чтобы на следующем ходе цикла работать уже со следующим элементом. 41 Универсальные коллекции Замечание: проверка на пустое значение для разных типов данных проводится по-разному. Только для ссылочных типов данных можно ее осуществлять посредством метода Пустая(). Как получить массив номенклатурных позиций, использованных в табличных частях «Номенклатура» и «Тара» накладной? Имеем ссылку на документ «СсылкаНаДокумент». Номенклатурные позиции могут быть указаны в колонке «Номенклат}фа» табличной части «Номенклатура» и в колонке «Номенклатура» табличной части «Тара». Тогда массив номенклатуры из обеих табличных частей можно получить следующим образом: Формируем массив «МассивНоменклатуры» посредством выгрузки колонки «Номенклатура» табличной части «Товары» документа. Аналогично формируем массив «МассивНоменклатурыТара» по табличной части «Тара». Далее в цикле перебора элементов второго массива добавляем их в первый. 42 Массив Есть две таблицы значений. Как получить массив совпадающих имен колонок? Данная операция может применяться для вспомогательного контроля перед загрузкой таблицы значений в таблицу записей регистра. Итак, есть «ТаблицаИсточник» PI «ТаблицаПриемник», требуется получить массив имен совпадающих по имени колонок. Создаем сначала конструктором «МассивСовпадающихКолонок». Далее выполняем цикл перебора колонок одной из таблиц. Внутри цикла в переменную «ИмяКолонки» получаем имя очередной колонки. Далее обращаемся к коллекции колонок другой таблицы значений и при помощи метода Найти() пытаемся найти такую же по имени колонку. Если поиск успехом не увенчается - метод выдаст значение Неопределено. А если удалось - добавляем очередной элемент к массиву «МассивСовпадающихКолонок». 43 Универсальные коллекции Как в запросе сделать отбор по нескольким вариантам заполнения реквизита типа «ПеречислениеСсылка»? Одним из приемов программирования, использующим массивы, является формирование коллекции возможных значений для заполнения параметров запроса. Это выполняется, например, когда в запросе используются отборы с операндами В или В ИЕРАРХИИ. Вот пример решения задачи: В параметр «МассивПричин» устанавливается значение - массив возможных причин, набранный из элементов перечисления « ПричиныОтсутствия». Замечание: для решения подобных задач (с операндами В и В ИЕРАРХИИ) можно передавать не только данные типа Массив, можно еще СписокЗначениЙ или вообще сформировать коллекцию возможных значений вложенным запросом в самом тексте запроса. Вариант выбора заполнения параметра зависит от конкретики самой задачи. 44 Массив Как из регистра сведений «РасчетчикиЗарплатыОрганизации» получить в виде массива всех расчетчиков зарплаты определенного подразделения организации? Периодический независимый регистр сведений «РасчетчикиЗарплатыОрганизации» имеет следующую структуру: Данную задачу можно решить посредством применения методов объектной модели или запросом. Пример решения посредством объектной модели: Создаем набор записей регистра. Устанавливаем отбор по значению измерения «ПодразделениеОрганизации». Читаем данные набора записей. Выгружаем колонку набора записей «Пользователь» в массив. Пример решения задачи посредством запроса: 45 Универсальные коллекции Источником в запросе будет таблица регистра «РегистрСведений.РасчетчикиЗарплатыОрганизации». Накладываем отбор по условию равенства поля «ПодразделениеОрганизации» определенному значению. В качестве выходных полей выбираем только «Пользователь». После выполнения запроса делаем выборку по результату запроса и в цикле перебора ее - формируем нужный массив. В данных примерах оба способа возвращают одинаковые результаты примерно за одинаковое время потому, что никаких дополнительных действий в процессе получения информации не требуется. Второй способ на первый взгляд кажется более длинным в отношении написания кода. Но если нам понадобится произвести отбор более чем по одному условию, или получить массив неповторяющихся значений - то вторым способом получить такие данные будет значительно легче и быстрее с точки зрения скорости исполнения. 46 Структура ® В каких ситуациях обычно используются объекты типа «Структура»? Структура является универсальной коллекцией, то есть объектом, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в ее использовании возникает, когда требуется работать с временным набором данных с чуть более сложной природой, нежели в массиве. Если элемент массива можно было характеризовать только числовым индексом и значением произвольного типа, то элемент структуры характеризуется строковым ключом и значением произвольного типа. Чаще всего структуры применяют в ситуациях, когда необходимо узнать или использовать имена реквизитов, свойств, полей, подчиненных объектов для тех или иных объектов; узнать или использовать значения реквизитов, свойств, полей, подчиненных объектов по их именам для тех или иных объектов. Кроме того, структуры удобно использовать для передачи параметров при работе с различными объектами. Структуры могут создаваться конструктором НОВЫЙ или получаться в результате применения методов некоторых объектов. Ввод элементов в структуру можно осуществлять как посредством параметров конструктора, так и посредством метода Вставить(). Как создать структуру? Создание структуры чаще всего происходит посредством оператора НОВЫЙ: где «СозданнаяСтруктура» - имя переменной, которая будет содержать созданный объект типа Структура. После вышеприведенного создания в структуру можно вставлять элементы (произвольное количество). 47 Универсальные коллекции Если же мы хотим создать структуру с заранее определенными элементами - это можно сделать, например, так: Первым параметром передается строка, в которой через запятую перечисляются ключи элементов структуры. Остальные параметры содержат значения для элементов структуры в том же порядке, в котором были перечислены ключи. Для такой структуры впоследствии можно обращаться к любому из элементов для записи или для чтения значения. А так же, при необходимости, к этой структуре можно еще добавлять новые элементы. Как добавить элементы в структуру? Для добавления элементов в структуру используется метод Вставить(). Первым параметром указывается ключ, вторым - значение нового элемента. Замечание: если в составе структуры уже был элемент с подобным ключом - то старый элемент будет замещен новым. Например: Как обратиться к элементу структуры? Для чтения значений элементов структуры можно использовать несколько вариантов написания кода. Для структуры «Оппонент», в составе которой есть элемент с ключом «Возраст» можно использовать явное указание значения ключа: 18 Структрура или передачу ключа в переменной: Также можно использовать метод СвоЙСТВО(), который получает значение элемента структуры по указанному ключу: Для записи значений элементов структуры использовать несколько вариантов написания кода. Если мы хотим изменить значение возраста в вышеописанного примера - можно это сделать так: также можно структуре из или так: или так: Как перебрать элементы структуры? Поскольку структура является коллекцией - перебрать элементы структуры можно посредством цикла перебора коллекции. Например, чтобы сообщить обо всех ключах и значениях элементов структуры «СтруктураПараметров», можно сделать следующее: 49 Универсальные коллекции Как удалить элемент структуры? Чтобы удалить элемент структуры - необходимо знать его ключ. Например, чтобы удалить из структуры «СтруктураПараметров» элемент с ключом «Номенклатура», достаточно сделать следующее: Если же нужно удалить все элементы структуры - применяется метод ОЧИСТИТЬ(): Как в структуре установить значение для элемента с определенным ключом? Все ключи элементов структуры - уникальны. Поэтому добавление новых элементов и замена (установка) значений для «старых» элементов выполняется одним и тем же методом Вставить^): Результатом примера выше будет структура, состоящая только из одного элемента: ключ у него - «Цвет», значение - «Синий» из системного набора значений \Л/еЬЦвета. Структрура Как получить в структуру многомерные данные? Как собрать информацию по установленным в форме журнала отборам? Для формы журнала документов установлены некие отборы. Чтобы сформировать многомерную структуру всех используемых отборов объекта «ЖурналДокументовСписок», можно сделать следующее: Создаем конструкторами две структуры. Структура «СтруктураОтборов» впоследствии будет содержать элементы, где в качестве ключа будет указано название отбора, а в качестве значения « СтруктураПараметровОтбора». В цикле перебора коллекции отборов объекта «ЖурналДокументовСписок» сначала проверяем, используется ли данный отбор. Если используется - заполняем структуру параметров данного отбора. Полученную структуру используем в качестве значения добавляемого элемента объекта «СтруктураОтборов». Впоследствии, если нам потребуется информация из полученной структуры, можно будет, например, перебрать элементы 51 Универсальные коллекции «СтруктураОтбора», а для каждого из этих элементов - перебрать элементы ее значения - структуры «ПараметрыОтбора» Как определить, есть ли в структуре элемент с ключом «Контрагент», и если есть, но содержит пустое значение справочника или Неопределено - удалить этот элемент? В качестве параметров метода СвоЙСТВО() можно указать ключ и переменную для получения значения по ключу. Кроме того, сам метод возвращает Истина, если элемент с данным ключом существует, и Ложь - если нет. Получив значение и проверив его на требуемые условия, удаляем элемент с указанным ключом из структуры. Замечание: кроме метода СвоЙСТВО() получить значения элемента структуры позволяют следующие варианты обращения по ключу: Структура-Контрагент или Структура[ "Контрагент" Структрура Как из табличной части «Товары» документа получить все строки, где значение реквизита «Цена» равно нулю, а значение реквизита «СтавкаНДС» равно значению «НДС18» перечисления «СтавкиНДС»? Для поиска строк, соответствующих условию определенного отбора, можно сделать следующее: СтруктураДляПоиска = Новый Структура("Цена, СтавкаНДС", О, Перечисления.СтавкиНДС.НДС 18); МассивСтрок = Товары. НайтиСтроки(СтруктураДляПоиска); Сначала создаем структуру для поиска. Далее посредством метода НаЙТиСтр0КИ() из табличной части документа «Товары» получаем массив строк, соответствующих отбору по структуре поиска. Обратите внимание, в данном примере был показан вариант добавления и заполнения элементов структуры непосредственно в конструкторе. Как получить данные о текущей учетной политике бухгалтерского учета организации из периодического регистра сведений на заданную дату? Периодический регистр сведений «УчетнаяПолитикаБухгалтерскийУчет» имеет следующую структуру: Тип значения измерения «Организация» СправочникСсылка. Организации. Ссылка на организацию находится в переменной «ЮрЛицо». Дата, на которую необходимо получить данные - переменная «ДатаПолучения». 53 Универсальные коллекции Получение необходимых данных можно организовать посредством метода ПолучитьПоследнее() менеджера регистра: Метод предназначен для получения данных наиболее поздней записи регистра, соответствующей указанным периоду и значениям измерений регистра. Значения измерений регистра должны предаваться в виде структуры. Каждый элемент структуры в качестве ключа должен использовать имя измерения. В качестве значения элемента структуры передаем значение отбора по этому измерению. Дату получения и полученную структуру отбора используем в качестве параметров для метода ПолучитьПоследнее(). Результатом применения метода к периодическому регистру сведений «УчетнаяПолитикаБухгалтерскийУчет» будет структура. Элементы полученной структуры состоят из названия ресурса в качестве ключа и значения ресурса в качестве значения. 54 Структрура Как сформировать структуру названий реквизитов табличной части произвольного документа? Пример функции, решающую данную задачу - ниже. В качестве параметров необходимо передать ссылку на документ и имя табличной части документа. Конструктором создаем структуру « Стру ктураТабл ичнойЧасти Доку мента». В цикле перебора реквизитов нужной табличной части полученного документа вставляем в структуру элементы с названиями полученных реквизитов. Замечание: значения элементам структуры можно было и не указывать - все зависит от того, как в дальнейшем собираемся использовать полученную структуру. Как получить запросом данные табличной части документа, имея структуру названий реквизитов табличной части? Пример функции, решающей данную задачу - ниже. В качестве параметров необходимо передать ссылку на документ или объект документа, имя табличной части и структуру названий реквизитов этой табличной части. 55 Универсальные коллекции Функция основана на сборе информации запросом, чей текст собирается «кусочками» из строковых переменных: Создаем переменную «ПоляРеквизитов». В цикле перебора элементов структуры имен полей табличной части добавляем к переменной «ПоляРеквизитов» «по кусочкам» будущие имена выходных полей запроса. Добавляются они через запятую. Далее формируем запрос, к тексту которого добавляем строку имен выходных полей запроса. Источником указываем таблицу нужной табличной части нужного документа. Кроме того, накладываем отбор по полю «Ссылка». Функция возвращает результат выполнения запроса. 56 Соответствие ф В каких ситуациях обычно используются объекты типа «Соответствие»? Соответствие является универсальной коллекцией, то есть объектом, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в его использовании возникает, когда требуется работать с временным набором данных с чуть более сложной природой, нежели в структуре. Если элемент структуры можно было характеризовать только строковым ключом и значением произвольного типа, то элемент соответствия характеризуется ключом произвольного типа и значением произвольного типа. Чаще всего соответствия применяют в ситуациях, когда необходимо хранить в оперативной памяти для последующей обработки данные с ключами произвольного типа. Кроме того, соответствия удобно использовать для передачи параметров при работе с различными объектами. Соответствия могут создаваться конструктором НОВЫЙ. ф Как создать соответствие? Создание соответствия происходит посредством оператора Новый: I СозданноеСоответствие = Новый Соответствие(); где «СозданноеСоответствие» «СозданноеСоответствие» - имя переменной, которая будет содержать созданный созданный объект типа типа Соответствие. Соответствие. содержать После вышеприведенного создания в соответствие можно вставлять элементы (произвольное количество). количество). элементы (произвольное ф Как добавить элементы в соответствие? Допустим к соответствию Допустим соответствию «ВозрастСотрудников» «ВозрастСотрудников» нужно добавить новый элемент. В качестве ключа должна выступать ссылка на сотрудника (ее можно считать из переменной «Сотрудник»), в качестве значения - возраст сотрудника (его можно считать из переменной «ВозрастСотрудника»). «ВозрастСотрудника»). 57 Универсальные коллекции Тогда добавление нового элемента можно произвести так: или так: Как обратиться к элементу соответствия? Запись значений элементов соответствия можно выполнять теми же способами, которые рассмотрены в вопросе «Как добавить элемент в соответствие?» на странице 57. А чтение значений элементов соответствия можно выполнять следующим образом: или так: В приведенных примерах из соответствия «ВозрастСотрудников» по ссылке на сотрудника в качестве ключа будет получено значение элемента соответствия. Как перебрать элементы соответствия? Поскольку соответствие является коллекцией - перебрать элементы соответствия можно посредством цикла перебора коллекции. Например, чтобы сообщить обо всех ключах и значениях элементов соответствия «Замены», можно сделать следующее: 58 Соответствие Как удалить элемент соответствия? Чтобы удалить элемент соответствия - необходимо знать его ключ. Например, чтобы удалить из соответствия «Замены» элемент со ссылкой на объект, содержащийся в переменной «УдаляемыйТовар», в качестве ключа, достаточно сделать следующее: Если же нужно удалить все элементы соответствия - применяется метод ОЧИСТИТЬ(): Как получить данные из соответствия? В соответствии «КурсыВалютДокумента» в качестве ключа используется значение валюты, а значениями являются структуры, содержащие «Курс» и «Кратность». Как получить курс и кратность валюты «УправленческаяВалюта» ? Сначала по ключу (ссылке на управленческую валюту) получаем значение соответствия. Поскольку значением является структура курса валют - далее получаем значения структуры по их названиям. 59 Универсальные коллекции Как получить многоуровневое соответствие видов расчетов, обладающих базовыми видами расчетов? Для плана видов расчетов «ОсновныеНачисления» необходимо получить соответствие «ВидыРасчетов», где в качестве ключей будут использоваться виды расчетов, обладающие базовыми. А в качестве значений - соответствия базовых видов расчетов. В качестве ключей последних - базовые виды расчета, в качестве значений - структуры, содержащие их свойства «Наименование» и «Предопределенный». Виды расчета Базовые виды расчета Оклад по дням Оклад по часам Ежегодный отпуск Оплата по часовому т арифу Оплата по дневному тарифу Оплата по произволе твенным нарядам Оклад по дням Надбавка за в редность Оклад по часам Оплата по произволе твенным нарядам Свойства базового вида расчета "Наименование" - "Оклад по дням" "Предопределенный" - Истина "Наименование" - "Оклад по часам" "Предопределенный" - Ложь "Наименование" "Оплата по часовому тарифу" "Предопределенный" - Ложь "Наименование" "Оплата по дневному тарифу" "Предопределенный" - Истина "Наименование" "Оплата по производственным нарядам" "Предопределенный" - Истина "Наименование" - "Оклад по дням" "Предопределенный" - Истина "Наименование" - "Оклад по часам" "Предопределенный" - Ложь "Наименование" "Оплата по производственным нарядам" "Предопределенный" - Истина Первичный сбор информации удобнее осуществить при помощи запроса с использованием итогов. Последующий перебор группировок результат запроса даст возможность сформировать необходимые объекты: 60 Соответствие Для запроса источником является таблица «ПланВидовРасчета.ОсновныеНачисленияОрганизации.БазовыеВидыРас чета». Выходными полями делаем все, необходимые для решения нашей задачи. Кроме того, вводим дополнительные итоги по полю «Ссылка» (ссылка на виды расчета). После выполнения запроса делаем выборку по верхнему уровню группировок результата запроса. 61 Универсальные коллекции Создаем конструктором три объекта - соответствие «ВидыРасчетов», в которое будем впоследствии добавлять виды расчетов, обладающие базовыми; соответствие «БазовыеВидыРасчетов», в которое будем добавлять базовые виды расчетов для каждого отдельного вида (владельца); структуру «СвойстваВидовРасчетов» для добавления информации о свойствах базовых видах расчетов. В цикле перебора верхнего уровня группировок (по видам расчета) сначала очищаем соответствие «БазовыеВидыРасчета». Далее открываем цикл перебора записей второго уровня группировки результата запроса (то есть уже по базовым видам расчетов определенного владельца). В этом цикле заполняем значения структуры «СвойстваВидовРасчетов» по ключам - названиям свойств. Далее добавляем сформированные структуры в качестве значений соответствия «БазовыеВидыРасчета» с конкретным базовым видом расчета в качестве ключа. По окончании вложенного цикла добавляем очередной элемент в соответствие «ВидыРасчетов» с заполнением значения ключа из поля «Ссылка», и заполненным соответствием «БазовыеВидыРасчета» в качестве значения. Список значений, таблица значений, дерево значений ® В каких ситуациях обычно используются списки значений, таблицы значений, дерево значений? Все эти объекты являются универсальными коллекциями, то есть объектами, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в использовании списка значений возникает, когда требуется работать с временным набором данных для решения интерфейсных задач. Дело в том, что в отличие от более простых универсальных коллекций (массива, структуры, соответствия) список значений состоит из объектов - ЭлементСпискаЗначениЙ. А элемент списка значений характеризуется следующим набором свойств: Значение; Представление. Содержит строковое пользовательское представление. То есть именно его пользователь увидит на экране. По умолчанию - генерируется автоматически; Пометка; Картинка; Применение списков значений для обычных задач универсальных коллекций, но не связанных с интерфейсными действиями, как правило - излишне. Обычно с этой функциональностью справляются объекты «попроще»: Массив, Структура, Соответствие. Таблицы значений позволяют работать с данными сущностей, представимых в виде таблиц, то есть «раскладываемых» на колонки и строки. А ведь с точки зрения многих систем автоматизации вообще «весь мир = совокупность таблиц». При этом можно добавлять/удалять данные (и колонки, и строки, и значения); искать данные (и колонки, и строки, и значения); сортировать данные (по любым колонкам); выгружать-загружать данные; подсчитывать итоги по колонкам; сворачивать данные и т.д. Дерево значений позволяет в добавление к вышеприведенным операциям еще вводить уровни иерархии для этих данных и оперировать в пределах уровней или игнорируя их. 63 Универсальные коллекции Подобный набор возможностей помогает решать самый широкий спектр задач промежуточной обработки данных произвольного типа. Как создать список значений? Список значений можно создать посредством оператора НОВЫЙ: где «СозданныйСписок» - имя переменной, которая будет содержать созданный объект типа СписокЗначении. Как добавить элементы в список значений? Например, требуется добавить в список значений «СписокСотрудников» новый элемент со значением ссылки на сотрудника (содержится в переменной «ТекущийСотрудник»), ФИО сотрудника в качестве представления (содержится в реквизите «ФИО» объекта «ТекущийСотрудник») и фотографии сотрудника в качестве картинки (содержится в переменной «Фото»): Если нужно, чтобы новые значения добавлялись с определенным индексом (переменная «Инд»), то можно использовать метод Вставить(): Если при этом в списке значений уже был элемент с таким индексом, то старый элемент получит индекс на единицу больше предыдущего; аналогично сдвинуться индексы у всех последующих. Если при использовании метода Вставить() указать индекс, выходящий за границы списка, - получим сообщение об ошибке. 64 Список значений, таблица значений, дерево значений Как найти элемент списка значений? Например, в списке значений «СписокСотрудников» надо найти элемент, в котором в качестве значения указан сотрудник, на которого ссылается переменная «ИскомыйСотрудник». Затем нужно сообщить индекс найденного элемента. Это можно выполнить следующим образом: Замечание: если искомое значение в списке может встретиться несколько раз - при таком подходе найдем только первый элемент, где оно содержится. Поэтому смотрите по ситуации. Поскольку список значения - объект, предназначенный, прежде всего для визуализации возможностей выбора пользователем, обычно при его заполнении уже сразу предотвращают возможность повторов. Если же такая возможность осмыслена, то получить все элементы списка значений, содержащие определенное значение можно, например, в цикле перебора элементов списка значений. Как обратиться к элементу списка значений? Если требуется получить доступ к элементу списка значений с определенным индексом (пусть содержится в переменной «Инд»), можно поступить так: или так: В любом случае - то, что получаем, еще не есть значение, заложенное в этот элемент списка (это еще не сотрудник), а именно объект типа ЭлементСпискаЗначений. 65 Универсальные коллекции Впоследствии с него можно считать значения свойств: Как перебрать элементы списка значений? Поскольку имеем дело с индексированной коллекцией, то можно использовать цикл перебора элементов коллекции или «цикл-счетчик». Например, чтобы сообщить значения всех элементов списка значений «СписокСотрудников», можно использовать следующий код: То же через «цикл-счетчик»: Как удалить элемент списка значений? Удаление отдельных элементов списка значений происходит с обязательным указанием индекса удаляемого элемента. Так, например, будет удален первый элемент массива: Естественно, если указанный индекс будет выходить за границу индексов списка - получим сообщение об ошибке. Кроме того, необходимо учитывать, что удаление элемента «из середины» списка приведет к уменьшению на единицу индексов элементов, стоявших «после» удаленного. Список значений - «сомкнет ряды». 66 Список значений, таблица значений, дерево значений Решим задачу удаления всех элементов списка «СписокОбъектов», содержащих числовые значения: значений Сначала определяем самый старший индекс элементов списка значений. Цикл проверок и удалений элементов будет выполняться, пока очередное значение индекса не окажется меньше нуля. В цикле определяем тип значения элемента с текущим индексом. Если это число - удаляем данный элемент. Кроме того, в любом случае уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор элементов списка значений производится с конца, то эффект «смыкания рядов» будет актуален только для уже проверенных элементов. ф Как создать таблицу значений и заполнить ее поля? Для создания таблицы значений используется оператор Новый: После этого молено создать колонки таблицы (при необходимости можно задать допустимые типы значений для колонки, заголовок и ширину колонки в символах). Затем можно добавить новую строку и установить значения в колонках таблицы: 67 Универсальные коллекции или так: Как найти значение в таблице значений? Если требуется «ТаблицаЗначений», сделать так: I найти первую где присутствует строку таблицы значений «ИскомоеЗначение», можно Найден наяСтрока = ТаблицаЗначений.Найти(ИскомоеЗначение); Если требуется найти первую строку, где «ИскомоеЗначение» может быть найдено, например, в колонках «Поставщик» и «Покупатель», то: Если же нужно найти все строки, где в колонке «Сотрудник» присутствует искомое значение, то это можно выполнить при помощи метода НаЙТиСтроки(): Сначала создаем структуру поиска, каждый элемент которой будет содержать название колонки таблицы значений в качестве ключа и искомое значение в этой колонке - в качестве значения. Далее структуру поиска передаем в качестве параметра методу НаЙТиСтроки(). Результат - массив строк таблицы значений, соответствующих структуре поиска. Список значений, таблица значений, дерево значений Замечание: если в этом примере в структуру поиска добавить поискнужного значения, например, еще и в колонке «Ответственный» - то в результате применения метода НаЙТиСтроки() получим все строки, где и «Сотрудник» и «Ответственный» равны искомому значению. Как перебрать строки таблицы значений? Поскольку имеем дело с индексированной коллекцией, то можно использовать цикл перебора элементов коллекции или «цикл-счетчик». Например, чтобы сообщить значения колонки «Сотрудник» всех строк таблицы значений «ТаблицаСотрудников», можно использовать следующий код: То же через «цикл-счетчик»: ® Как удалить строки (колонки) таблицы значений? Удаление отдельных строк таблицы значений происходит с обязательным указанием удаляемой строки или индекса удаляемой строки. Если нужно удалить строку «УдаляемаяСтрока», входящую в таблицу значений «ТаблицаЗначений»: А так, например, будет удалена первая строка таблицы значений: 69 Универсальные коллекции Естественно, если указанный индекс будет выходить за границу индексов строк таблицы значений - получим сообщение об ошибке. Аналогично и для колонок. Только работать уже надо с коллекцией колонок таблицы значений. Доступ к ней - через свойство КОЛОНКИ таблицы значений. или Кроме того необходимо учитывать, что удаление строки (или колонки) «из середины» таблицы значений приведет к уменьшению на единицу индексов строк, стоявших «после» удаленной (эффект «смыкания рядов», вернее -«смыкание строк»). Например, решим задачу удаления всех строк таблицы значений «ТаблицаЗначений», содержащих числовые значения хотя бы в одной колонке: Сначала определяем самые старшие индексы строк и колонок таблицы значений. Цикл проверок и удалений строк будет выполняться, пока очередное значение индекса строки не окажется меньше нуля. Внутри цикла но строкам делаем цикл-счетчик перебора индексов колонок. Во вложенном цикле определяем тин значения элемента находящегося в строке с текущим индексом и в очередной колонке. Если 70 Список значений, таблица значений, дерево значений это число - удаляем строку таблицы значений и прерываем вложенный цикл. Кроме того, в любом случае на каждом шаге внешнего цикла уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор строк таблицы значений производится с конца, то эффект «смыкания рядов» будет актуален только для уже проверенных элементов. Как заполнить таблицу значений, если имена колонок содержатся в переменных? Если имя колонки, для которой требуется установить значение, содержится в переменной, можно использовать оператор : В вышеприведенном коде: «ТаблицаЗначений» - имя таблицы значений; «ИмяКолонки» - строковая переменная, содержащая имя колонки, по которой нужно заполнить значение; «Значение» - переменная, содержащая само заполняемое значение. Как заполнить всю колонку таблицы значений нужным значением? Колонку «ФлагФискального Учета» в таблице «ТаблицаЗначений» необходимо заполнить значением Ложь. значений Применяем для таблицы значений метод ЗаполнитьЗначения(). Первым параметром передаем заполняемое значение. Вторым параметром - имя заполняемой колонки. Замечание: если нужно заполнить несколько колонок значением - их имена указывают через запятую во втором параметре. Если не указать второй параметр - значением заполнятся все поля таблицы. 71 Универсальные коллекции Как таблицу значений «ТаблицаПолучатель» заполнить данными таблицы значений «ИсходнаяТаблица»? Если «ТаблицаПолучатель» на момент выполнения операции еще не существует, или ее предыдущие колонки сохранять не нужно, можно создать ее, как полную копию исходной: Вариант второй: таблица «ТаблицаПолучатель» существует, и жалко терять ее колонки и ограничения на типы данных колонок. Но нужно заполнить данные по колонкам, имена которых совпадают с именами исходной таблицы. Тогда можно так: Для каждой строки исходной таблицы добавляется новая строка в таблицу получатель и выполняется заполнение значений в тех колонках новой таблицы, имена которых совпадают с именами колонок в исходной таблице. Замечание: если у таблиц не будет колонок с одинаковыми именами - таблица-получатель будет в результате содержать столько же строк с пустыми значениями, сколько строк было в таблице-источнике. Если у каких-то одноименных колонок тип значения данных из таблицы-источника не попадет в массив разрешенных типов колонки таблицы-получателя - в таких полях получим пустые значения. Рассмотрим третий случай. В случае одноименных колонок - колонку таблицы-получателя нужно привести в полное соответствие колонке таблицы-источника. 72 Список значений, таблица значений, дерево значений Нам придется заменить колонку в таблице получателе на новую, чьи свойства полностью будут соответствовать колонке таблицы-источника. Поэтому в случае обнаружения в таблице-получателе одноименной колонки собираем в переменных все свойства для новой колонки. Далее удаляем старую и создаем новую колонку. Далее выполняем цикл перебора строк исходной таблицы. В цикле добавляем к таблице-получателю новую строку и открываем цикл перебора имен колонок в массиве совпадающих колонок. Внутри этого вложенного цикла производим заполнение ячеек таблицы получателя данными ячейки таблицы-источника. 73 Универсальные коллекции Как добавить колонки к таблице значений «ТаблицаЗначений» с ограничениями по типу? При добавлении колонки можно просто указать ее имя, а второй параметр метода Добавить() - не трогать. В этом случае тип данных колонки - произвольный. Можно заполнить значение второго параметра. Туда необходимо передавать описание разрешенного для колонки типа. Само описание можно получить при помощи конструктора, передав последнему в качестве параметра строковое название типа (если много типов - через запятую) или массив допустимых типов. Если среди типов разрешенных к заполнению данных колонки есть строка - можно ограничить ее разрядность (длину), указать использование неременной или фиксированной длинны. Все это обеспечивается созданием объекта при помощи конструктора КвалификаторыСтроки. Далее этот объект будет использован в качестве одного из параметров конструктора ОписаниеТипов. Аналогичные действия можно квалификаторов числа и даты. 74 осуществлять в отношении Список значений, таблица значений, дерево значений Обратите внимание, описание типов можно строить конструктором как «с нуля», так и использовать как основу уже существующее описание типов. Как изменить тип значения колонки таблицы значений, полученной выгрузкой из запроса? Запросом собираются данные по документам «Посту плениеТоваров Услуг» PI выгружаются в таблицу значений «ТаблицаСсылок» (колонка «Ссылка»). Впоследствии к этой таблице значений будут добавляться еще строки. Как обеспечить возможность добавления в полученную таблицу значений в колонку «Ссылка» документов других видов («ОприходованиеТоваров», « ВозвратОтПокупателя») ? При выгрузке данных из запроса в таблицу значений тип значения колонок определяется типом значений колонок результата запроса. Поэтому одним из самых простых вариантов решения задачи может быть воздействие на запрос, а не на таблицу значений. 75 Универсальные коллекции Создаем пустые ссылки на документы «ОприходованиеТоваров» и «ВозвратОтПокупателя». Далее в запросе делаем объединение с записями, содержащими эти пустые ссылки. Причем в объединяемых запросах по пустым ссылкам применяем ПЕРВЫЕ 0 для того, чтобы впоследствии не удалять строки с пустыми ссылками из таблицы выгруженного результата запроса После выполнения и выгрузки запроса в таблицу значений «ТаблицаСсылок» тип значения колонки «Ссылка» будет составным: «NULL, ДокументСсылка ЛоступлениеТоваровУ слуг, ДокументСсылка. ОприходованиеТоваров, ДокументСсылка.ВозвратОтПокупателя». То есть - то, что и требовалось. Как самостоятельно заполнить дерево значений? Для иллюстрации данной возможности создадим обработку, в которой определен реквизит «Дерево» (тип ДеревоЗначениЙ). В диалоге определено табличное поле, связанное через свойство данные с реквизитом «Дерево» (имя элемента управления «Дерево»). Следующая процедура произведет запись данных в дерево значений. 76 Список значений, таблица значений, дерево значений Следующая процедура показывает один из вариантов установки текущего значения в элементе управления, связанного с деревом (табличном поле). 77 Прикладные объекты Справочники © Как создать элемент (группу) справочника? Создание нового элемента в неиерархическом справочнике можно выполнить при помощи следующего кода: Если справочник иерархический, то выполнение этого кода приведет к созданию нового элемента в корне справочника. Для того чтобы создать новый элемент в определенной группе иерархического справочника, необходимо также указать родителя создаваемого элемента: Если требуется создать новую группу в иерархическом справочнике, то для этого следует использовать метод менеджера справочника Создать Груп пу (). Если группа должна находиться внутри 78 Справочники определенной группы справочника, также следует указать и родителя создаваемой группы: Следует обратить внимание на тот факт, что у реквизитов, в которые будет производиться запись значений в свойстве «Использование» должно стоять одно из перечисленных ниже значений: Для группы Для группы и элемента Если для справочника установлен вид иерархии Иерархия элементов, то для создания новых элементов следует использовать метод СоздатьЭлемент() менеджера справочника, а иерархия создаваемых элементов будет определяться значением свойства Родитель объекта справочника: 79 Прикладные объекты Как найти элемент справочника? Для поиска элемента справочника можно использовать несколько способов. По коду: При организации поиска по коду обращайте внимание на тип кода справочника (Число или Строка). По наименованию: По реквизиту: Во всех методах поиска есть параметры позволяющие искать в нужной группе, в рамках подчинения определенному элементу справочника владельца и ряд других параметров. 80 Справочники Как удалить элемент справочника? Для корректного удаления элемента справочника необходимо убедиться в том, что другие данные не содержат ссылок на удаляемый элемент справочника. Например, в переменной «СсылкаНаУдаляемыйЭлемент» содержится ссылка на удаляемый элемент справочника: Для пометки элемента справочника на удаление можно использовать метод УстановитьПометкуУдаления() объекта справочника: Использование этого метода позволяет установить или снять пометку на удаление элемента справочника, причем будут инициированы события Перед записью и При записи объекта справочника, поскольку выполняется сохранение измененного свойства ПометкаУдаления объекта справочника. 81 Прикладные объекты Как перебрать элементы справочника? Для того чтобы перебрать элементы справочника, необходимо сформировать выборку элементов с нужными параметрами и затем обойти ее в цикле. Например, для перебора всех элементов справочника «Номенклатура» в иерархическом порядке, можно использовать следующий код: Аналогичного результата можно добиться, используя запрос: Благодаря использованию запроса можно формировать выборку элементов справочника более «гибко», поскольку запрос позволяет задать произвольные условия на выбираемые данные. 82 Справочники ® Как выбрать все элементы из определенной группы? Организуем выборку элементов справочника из группы, ссылка на которую определена в переменной «ПолеВводаРодитель»: В результате работы этого кода будут получены все дочерние элементы выбранного элемента справочника. Аналогичное действие, выполняемое с помощью запроса, будет выглядеть следующим образом: 83 Прикладные объекты Если необходимо получить не только дочерние элементы, но и все элементы, находящиеся в иерархии выбранного элемента, следует, при использовании объектной техники, выполнять метод ВыбратьИерархически() менеджера справочника: а при использовании запроса применять условие В ИЕРАРХИИ: 81 Справочники ® Как перебрать элементы подчиненного справочника с помощью запроса? Справочник «КонтактныеЛица» подчинен справочнику «Контрагенты». Требуется перебрать всех контактных лиц определенного контрагента. Ссылка на данного контрагента находится в переменной «Контрагент». Делаем запрос по таблице справочника «Контактные лица» с отбором по полю «Владелец». В качестве владельца передаем ссылку на элемент справочника «Контрагенты». 85 Прикладные объекты ® Как перебрать элементы подчиненного справочника с помощью выборки справочника? Справочник «КонтактныеЛица» подчинен справочнику «Контрагенты». Требуется перебрать всех контактных лиц определенного контрагента. Ссылка на данного контрагента находится в переменной «Контрагент». ф Как открыть форму списка (элемента) справочника? Для того чтобы открыть форму списка справочника, можно воспользоваться методом ПолучитьФормуСписка() менеджера справочника: Для того чтобы открыть произвольную форму справочника, можно использовать метод ПолучитьФорму() менеджера справочника: Однако следует помнить, что если методом ПолучитьФорму() выполняется получение формы элемента или группы справочника, то будет получена форма нового элемента (группы). Справочники Для того чтобы открыть форму существующего элемента или группы справочника, следует использовать метод ПолучитьФорму() ссылки или объекта справочника: ® Как добавить запись в табличную часть элемента справочника? Имеется ссылка на элемент справочника «Контрагенты». Как добавить запись в табличную часть «ВидыДеятельности» этого элемента? Модифицировать можно только объект справочника. Поэтому так: Получаем объект справочника от ссылки на элемент. Добавляем новую строку к табличной части полученного объекта. Заполняем реквизиты табличной части в данной строке. Записываем измененный элемент справочника. Как удалить строки из табличной части справочника? Для того чтобы полностью очистить табличную часть элемента справочника, можно воспользоваться методом ОЧИСТИТЬ() табличной части справочника: 87 Прикладные объекты Если требуется выборочное удаление строк табличной части (например, в зависимости от значения их реквизитов), можно сначала отобрать строки, удовлетворяющие условию, а затем удалить каждую из них методом Удалить() табличной части справочника. В следующем примере подразумевается, что переменная «ВыбранныйЭлемент» содержит ссылку на обрабатываемый элемент справочника, а переменная «ВыбранныйВидДеятельности» содержит ссылку на вид деятельности, который не должен присутствовать у обрабатываемого элемента: ф Как перебрать строки табличной части справочника? Табличная часть справочника представляет собой коллекцию строк, которую можно перебрать в цикле. Реквизиты табличной части будут доступны как свойства строки табличной части. Например, перебор строк табличной части «ВидыДеятельности» справочника «Контрагенты» может быть выполнен следующим образом: Справочники ® Как создать элемент в нужной группе? Необходимо создать элемент справочника номенклатура, так чтобы при этом он попал в нужную группу. Если группы с указанным кодом нет, то тогда такая группа должна быть создана. Можно использовать предопределенную группу, в этом случае вместо поиска и создания новой группы можно использовать строку: 89 Прикладные объекты Обратите внимание на тот факт, что механизм работает, только если в справочнике установлен вид иерархии «Иерархия групп и элементов». В противном случае код будет выглядеть следующим образом: Если вид иерархии справочника «Иерархия элементов», то понятие группы в нем отсутствует. Как узнать, есть ли у текущего элемента подчиненные? Пусть ссылка на текущий элемент справочника содержится в переменной «Владелец». Необходимо узнать, есть ли в справочнике «Единицы измерения» элементы, подчиненные текущему элементу. Если использовать объектную модель доступа: 90 Справочники Фактически получаем выборку всех подчиненных элементов и если в выборке есть хоть одна позиция, считаем, что подчиненные элементы существуют. Именно этот факт и говорит о неэффективности использования данного варианта (выбираемые данные мы не используем, а получаемый блок данных может быть большим). Лучше всего подобную проверку можно выполнить, используя возможности запросов: Так как не предполагается, что нам понадобятся данные о подчиненном элементе, выборку результата запроса в переменной не сохраняем. Как узнать количество подчиненных элементов у выбранного элемента справочника? Необходимо определить количество элементов в справочнике «ЕдиницыИзмерения» подчиненных элементу справочника, ссылка на который находится в переменной «Владелец». С помощью объектной модели: 91 Прикладные объекты Данное решение в общем случае является не эффективным. Связано это с тем, что выборка фактически получает все данные о подчиненных элементах справочника, а в рамках данной задачи нужно только количество элементов. Если решать задачу с помощью запроса, то решение выглядит следующим образом: В результате в переменной «КоличествоЗаписей» будет находиться нужная нам величина. Справочники Как узнать количество подчиненных элементов у выбранного элемента справочника, если количество подчиненных справочников больше чем один? Если у справочника есть несколько подчиненных справочников, то запрос может выглядеть следующим образом: Данный запрос позволяет получить количество записей в двух подчиненных справочниках. В качестве источника данных в основном запросе используется подзапрос («ВложенныйЗапрос»). Сам подзапрос состоит из двух запросов (происходит их объединение). Каждый из объединяемых запросов получает данные о количестве записей в одном из подчиненных справочников. В выборке результата запроса (в случае если у элемента справочника, ссылка на который находится в переменной «Владелец», есть подчиненные элементы) будет одна строка, в поле «КоличествоПодчиненныхЭлементов» которой содержится количество подчиненных элементов. 93 Прикладные объекты Как получить всех родителей выбранного элемента справочника? В переменной «СсылкаНаЭлемент» находится ссылка на элемент справочника. Необходимо получить всех родителей данного элемента Перебрать всех родителей можно используя строки кода: Данную задачу можно решить и с помощью запроса, однако следует учитывать, что в языке запросов не предусмотрено специальных средств для получения всех родителей элемента. Для выполнения задачи можно воспользоваться, например, иерархическими итогами, текст запроса будет выглядеть следующим образом: Результат запроса будет содержать одну «лишнюю» запись, которую легко «отсеять» проверкой свойства «ЭтоГруппа». 94 Справочники Однако получение иерархических итогов оптимизировано для построения итогов большого количества записей, и не вполне эффективно для получения родителей одного элемента. Для более эффективного получения всех родительских записей элемента, рекомендуется перебирать в цикле его родителей небольшими порциями, например, так: 95 Прикладные объекты В данном примере в окно служебных сообщений выводятся все родители для ссылки, записанной в переменную «ЭлементНоменклатура». В цикле выбирается по 5 родителей ссылки. Если число уровней в справочнике ограничено и невелико, то возможно получение всех родителей одним запросом без цикла. Как получить запросом «полный» код элементов справочника, если тип кода Строка? Понятие «Полный код» соответствует объектной модели системы. Это свойство объектов «СправочникСсылка» и «СправочникОбъект», содержащее указание кодов элемента и всех родителей его иерархии. Представляет собой строку, в которой указаны коды всех вышестоящих элементов иерархии, начиная с самого верхнего уровня и разделяемые символом «/» заканчивая кодом самого элемента. В табличной модели хранения информации никакого поля «ПолныйКод» для таблиц справочника не существует. Однако можно говорить о значении поля «Родитель» каждой из записей таблиц справочников и о значении поля «Код». Поэтому запрос по трехуровневому справочнику «Контрагенты» будет выглядеть следующим образом: Источником является таблица справочника. Из нее выбираем поле «Ссылка» и вычисляемое поле «ПолныйКод». Вычисление полного кода производим путем сборки его из значений кодов самого элемента и кодов всех вышестоящих родителей. Для этого для каждой записи сначала определяем ее уровень. 96 Справочники Уровень определяем следующим образом: для записей корневого уровня поле «Родитель» содержит пустую ссылку на элемент справочника, поэтому значение поля «Код» этого «Родителя» будет NULL. Если это условие выполнилось - значит, элемент находится на корневом уровне, и в качестве полного кода достаточно указать код. Если условие не выполнилось - проверяем аналогичным способом элемент на принадлежность к первому уровню. В случае выполнения условия - выводим уже код родителя и код самого элемента через «/». Таким же образом можно построить «сборку» поля «ПолныйКод» для случаев 4-х, 5-ти и т.д. уровневых справочников. В отношении возможных возражений о «неуниверсальности» подобного подхода: хотя, в общем случае, количество уровней справочника может быть не ограничено, сложно представить себе реальную практику использования справочника более чем с 10 уровнями вложенности из-за явного неудобства работы пользователя с таким «глубоким» справочником. Как получить все элементы справочника, содержащие в наименовании определенную подстроку, со всей иерархией, в которую они входят? Допустим, речь идет о справочнике «Контрагенты». Лучше всего с данной задачей справится запрос со следующим текстом: 97 Прикладные объекты Источником запроса является таблица справочника. Делаем отбор по наименованиям, в составе которых присутствует значение параметра «ЧастьНаименования». Условие отбора обеспечивается посредством оператора проверки строки на подобие шаблону. В шаблоне служебными символами «%» обозначается, что перед и после части строки, считанной из «ПолеВводаПодстрока», может встречаться произвольное количество других символов. Как найти все элементы справочника, в которых не заполнен строковый реквизит? Получить желаемое можно таким запросом: Проверка пустой строки выполняется за счет операции сравнения «=». В данном случае будут отобраны и элементы, в которых пользователь ничего не вводил и даже те, в которые он ввел только пробел (или пробелы). Но на некоторые реквизиты при работе с формой накладывают маску. В таких случаях случайный ввод хотя бы одного пробела уже не позволяет данному реквизиту быть пустым. Его значение будет содержать маску с пробелами. Для того, чтобы «защитить пользователя от самого себя» в подобных случаях запрос лучше немножко изменить. Например, для реквизита с маской «999-999-999 99» запрос будет выглядеть таким образом: Количество пробелов соответствовать маске. перед и между символами «-» должно Справочники Как перенести все элементы справочника «Контрагенты» из одной группы в другую? Для этого необходимо перезаполнить значением нового родителя реквизит «Родитель» у элементов, непосредственно являющихся «потомками» исходного родителя. Итак, пусть переменная «СтарыйРодитель» содержит старого, а «НовыйРодитель» - нового родителя. Получение элементов справочника, которым нужно поменять родителя, производим следующим образом: Источником для запроса является таблица справочника «Контрагенты». Делаем отбор непосредственно по полю «Родитель» и получаем таблицу ссылок на нужные нам элементы справочника. Далее: В цикле обработки результата запроса производим получение объекта по ссылке. Для каждого полученного объекта производим запись нового родителя в реквизит «Родитель» и непосредственную запись объекта с измененными данными. 99 Прикладные объекты Как организовать программный выбор элемента справочника? Требуется из одной формы (например, формы документа) открыть для выбора элемента форму справочника. После того, как значение будет выбрано в форме справочника, его необходимо получить для дальнейшей обработки в форме документа. Для получения выбранного значения используется обработчик события Обработка выбора формы владельца (в нашем случае формы документа). Вместо метода Открыть() объекта Форма Выбора в ряде случаев можно использовать метод ОткрытьМодально(). В этом случае окно откроется в модальном режиме и пока данная форма не будет закрыта
Электронная книга распространяется в виде архива, содержащего:
- исполняемый exe-файл, который включает в себя как саму книгу, так и программу SunRav BookReader, предназначенную для просмотра этой книги
- каталог с дополнительными материалами к книге.
- книга предназначена для чтения под ОС Windows
Книга 1С:Предприятие 8.1. Простые примеры разработки представляет собой справочное пособие, иллюстрирующее простые примеры разработки алгоритмов на платформе 1С:Предприятия 8.1.
Издание будет полезно начинающим разработчикам, администраторам, у которых на предприятии внедряется система, и продвинутым пользователям, которые хотят самостоятельно дорабатывать прикладные решения.
Книга 1С:Предприятие 8.1. Простые примеры разработки содержит большое количество практических примеров, сгруппированных по тематике использования.
В помощь разработчикам прикладных решений к книге прилагаются коды описанных примеров. Код примеров представлен в виде файла шаблонов текста 1С:Предприятия 8. Этот файл можно подключить к любой конфигурации и перетаскивать примеры мышью или вставлять их в модуль, используя автозамену.
После подтверждения оплаты книги вы получите:
* Файлы.epub на компьютере рекомендуется читать с использованием программы для чтения Adobe Digital Editions. При чтении с помощью других программ не рекомендуется использовать режим просмотра, предусматривающий показ двух страниц одновременно – в связи с большим количеством изображений возможно некорректное отображение.
Чем скачиваемые товары лучше?
Не надо платить за доставку, вы получаете журнал в пару кликов в любое время суток;
Скорость скачивания зависит только от возможностей вашего подключения, менеджеры закачки поддерживаются;
При возникновении проблем с получением покупки вы можете обратиться к нашим онлайн-консультантам;
Фирма 1С прикладывает довольно много усилий для обучения программистов, которые ведут разработку на базе 1С. Один из главных методов обучения — выпуск литературы для на прикладном языке 1С 8. Рассмотрим подробнее самые популярные книги по программированию, которые должен прочесть каждый уважающий себя .
Начнем рассмотрение с очень полезных книг, которые идут в комплекте с каждой программой 1С (комплект может незначительно различаться).
Книги из «коробки» программы 1С
1С:Предприятие 8 Руководство по установке и запуску
Книга для начинающих администраторов и программистов, где расписаны технические нюансы , установки ключей лицензий, рекомендуемые настройки .
1С:Предприятие 8 Описание встроенного языка
Книга выпущена в четырех частях. В них Вы найдете достаточное полное описание встроенного , описание языка запросов, описание встроенных методов, описание прикладных объектов и т.д.
1С:Предприятие 8 Конфигурирование и администрирование
Книга содержит информацию, которая будет полезна как программистам, так и администраторам. Книга содержит в себе описание основных объектов метаданных системы и способы её использования.
1С:Предприятие 8 клиент-сервер. Особенности установки и использования (для поставок «клиент-сервер»)
Данная литература предоставляется только с поставками для установки в клиент-серверном режиме работе. Книга описывает методы настройки серверов 1С, особенности настройки клиентских приложений, настройки защиты сервера, особенности функционирования и настройки информационной системы.
1С:Предприятие 8.2. Простые примеры разработки
Отличная книжка для начинающих разработчиков. В литературе описаны примеры реальных задач и их подробное решение. Книга разделена на девять глав, рассортированных по видам задач. Эта небольшая книга может стать верным помощником на первых порах изучения .
1С:Предприятие 8.3. Практическое пособие разработчика
Получите 267 видеоуроков по 1С бесплатно:
Книга является логическим продолжением «Простых примеров разработки» — она содержит решение более сложных прикладных задач. Книга написана с учетом последних нововведений в системе 1С Предприятие 8.3, в т.ч. управляемые формы.
В целях популяризации языка программирования фирма 1С установила на эту книгу очень выгодную цену — от 140 рублей для партнеров и от 240 рублей для розничных покупателей.
Решение специальных прикладных задач в «1С:Предприятии 8.2»
Данная книга позволит углубиться в решение действительно сложных задач. Причем сложных не только с технической точки зрения, но и с методологической. В книге описано решение узкоспециализированных задач, таких как автоматизация бизнес-процессов, анализ данных, построение аналитических отчетов и др. Литература предназначена для опытных программистов 1С.
Профессиональная разработка в системе 1С:Предприятие 8.3″
Книга, которую окрестили «Библией 1С». Книга имеет формат двухтомника А4 и суммарно содержит 1 400 листов знаний. В литературе описан весь спектр возможностей и функций встроенной среды разработки. Информация изложена в энциклопедичном виде. Рекомендую как настольную книгу, с помощью которой Вы можете в любой момент освежить в памяти нужный момент. Книга объединяет в себе практически всю литературу по разработке.
Книга выпущена для получения ответов на вопросы, которые возникают в процессе разработки управляемых форм. В литературе рассмотрено огромное количество примеров, среди которых Вы наверняка найдете свою задачу. Книга разбита на четыре раздела — конструирование командного интерфейса, конструирование форм, программирование форм и оптимизация клиент-серверного взаимодействия.
Разработка сложных отчетов в «1С:Предприятии 8.3». Система компоновки данных
— очень важных механизм 1С предприятия. Однако вместе с важностью механизм считается достаточно сложным для понимания разработчиков. В книге изучается система компоновки данных начиная с объяснения терминов и построения легких отчетов и заканчивая сложнейшими аналитическими отчетами.
Технологии интеграции 1С:Предприятия
Книга станет незаменимым помощником для разработчиков, занимающихся интеграцией с другими информационными системами. В книге рассмотрены интеграционные примеры с использованием следующих технологий: txt, dbf, xml, zip, HTML, excel, FTP, HTTP, e-mail, Web-services и тд.
1С:Предприятие 8. Конвертация данных: обмен данными между прикладными решениями
Данная книга поможет разобраться в создании правил обмена между различными конфигурациями. В ней описаны основы написания правил обмена в конфигурации . Однако во многом эта книга — копия встроенной справки в конфигурацию Конвертация данных.