Работа в 1С 20

СписокЗначений ТипРаботника создавался программно, но Панели элементов управления (диалога) имеются кнопки и , который позволяют создать и разместить на форме СписокЗначений как Список и Поле со списком (выпадающий список). Рассмотрим использование этих элементов. Пусть в выпадающем списке для принятых работников задается срок следующей аттестации (через 5 лет, через 7 лет, через 10 лет). Для создания на форме выпадающего списка можно воспользоваться кнопкой , но удобнее пользоваться кнопкой , что мы и сделаем. Нажмите . В появившемся окне (рисунок 6.1.2) задайте следующие параметры и нажмите кнопку ОК.

Рисунок 6.1.2

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

Рисунок 6.1.3

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

В документе ПриказОПриеме создайте реквизит шапки СрокАтт (Тип – Число, Длина – 2), куда будет сохраняться выбор из созданного списка.

При открытии окна необходимо заполнить список конкретными значениями. Для этого в начало процедуры ПриОткрытии() добавим следующие строки:

СрокАттестации.ДобавитьЗначение(5,"через 5 лет");

СрокАттестации.ДобавитьЗначение(7, "через 7 лет");

СрокАттестации.ДобавитьЗначение(10,"через 10 лет");

Напоминаем, что второй параметр – это экранное представление элемента списка, то есть в выпадающем списке будут значения из второго параметра.

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

Далее необходимо сохранять выбор из списка в реквизите СрокАтт. Для этого запрограммируем процедуре СрокАттестации(), созданную автоматически:

Процедура СрокАттестации()

СрокАтт=СрокАттестации.ПолучитьЗначение(СрокАттестации.ТекущаяСтрока());

КонецПроцедуры

Кроме того, при открытии уже существующего приказа необходимо, чтобы в списке была выбрана строка, соответствующая сохраненному реквизиту СрокАтт. Для этого в процедуру ПриОткрытии() добавим установку текущем строки списка:

Процедура ПриОткрытии()

СрокАттестации.ДобавитьЗначение(5,"через 5 лет");

СрокАттестации.ДобавитьЗначение(7, "через 7 лет");

СрокАттестации.ДобавитьЗначение(10,"через 10 лет");

Док=СоздатьОбъект("Документ.ПриказОПриеме");

Попытка

Если Док.НайтиДокумент(ТекущийДокумент())=1 Тогда

СрокАттестации.ТекущаяСтрока(СрокАттестации.НайтиЗначение(СрокАтт));

Если Док.Проведен()=1 Тогда

Форма.ТолькоПросмотр(1);

Форма.ОК.Доступность(0);

КонецЕсли;

КонецЕсли;

Исключение

КонецПопытки;

КонецПроцедуры

При необходимости в справочнике Сотрудники можно ввести реквизит СрокАттестации и при проведении документа сохранять в него данные.

6.2 Таблица значений

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

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

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

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

Для создания таблицы значений используется метод СоздатьОбъект():

Табл = СоздатьОбъект("ТаблицаЗначений");

КоличествоКолонок(<КоличКолонок>) – устанавливает/возвращает количество колонок таблицы значений.

Параметры:

<КоличКолонок> – необязательный параметр. Числовое выражение, которое указывает новое количество колонок. Если параметр опущен, то количество колонок не меняется.

Возвращаемое значение: количество колонок до вызова метода.

Пример:

Разм = Табл.КоличествоКолонок();

НоваяКолонка(<Идентификатор>, <Тип>, <Длина>, <Точность>, <3аголовок>, <Ширина>,<Формат>, <Положение>) – добавляет в конец таблицы значений новую колонку.

Параметры:

<Идентификатор> – необязательный параметр. Идентификатор колонки, если не указан обращение к колонке возможно только по номеру.

<Тип> – необязательный параметр. Строка или вид субконто, задающий тип колонки. Если не указан, то можно хранить любой тип.

<Длина> – необязательный параметр. Длина для числовой или строковой колонки.

<Точность> – необязательный параметр. Точность (длина дробной части) для числовой колонки.

<3аголовок> – необязательный параметр. Строковое выражение, содержащее заголовок колонки в элементе диалога типа ТаблицаЗначений.

<Ширина> – необязательный параметр. Числовое выражение, содержащее ширину колонки (в символах) для представления колонки в элементе диалога типа ТаблицаЗначений.

<Формат> – необязательный параметр. Строковое выражение, содержащее форматную строку, которая будет использована при визуальном отображении значений данной колонки.

<Положение> – необязательный параметр. Определяет вариант выравнивания при визуальном отображении значений данной колонки: 1 – слева; 2 – справа.

Возвращаемое значение: номер новой колонки.

Пример:

Табл.НоваяКолонка("Код", "Число", 6, 0, "Код", 6);

ВставитьКолонку(<Идентификатор>, <НомерКолонки>, <Тип>, <Длина>, <Точность>, <3аголовок>, <Ширина>, <Формат>, <Положение>) – вставляет новую колонку в таблицу значений в указанную позицию.

Параметры:

<Идентификатор> – необязательный параметр. Идентификатор колонки, если не указан обращение к колонке возможно только по номеру.

<НомерКолонки> – необязательный параметр. Числовое выражение, содержащее позицию, в которую вставляется новая колонка.

<Тип> – необязательный параметр. Строка или вид субконто, задающий тип колонки. Если не указан, то можно хранить любой тип.

<Длина> – необязательный параметр. Длина для числовой или строковой колонки.

<Точность> – необязательный параметр. Точность (длина дробной части) для числовой колонки.

<Заголовок> – необязательный параметр. Строковое выражение, содержащее заголовок колонки в элементе диалога типа ТаблицаЗначений.

<Ширина> – необязательный параметр. Числовое выражение, содержащее ширину колонки (в символах) для представления колонки в элементе диалога типа ТаблицаЗначений.

<Формат> – необязательный параметр. Строковое выражение, содержащее форматную строку, которая будет использована при визуальном отображении значений данной колонки.

<Положение> – необязательный параметр. Определяет вариант выравнивания при визуальном отображении значений данной колонки: 1 – слева; 2 – справа.

Возвращаемое значение: номер новой колонки.

Пример:

Табл.ВставитьКолонку("Код", 1, "Число", 6, 0, "Код", 6);

УдалитьКолонку(<Колонка>) – удаляет колонку <Колонка> из таблицы значений.

Параметры:

<Колонка> – номер или идентификатор колонки.

Пример:

Табл.УдалитьКолонку(2);

УстановитьПараметрыКолонки(<Колонка>, <Тип>, <Длина>, <Точность>, <3аголовок>, <Ширина>, <Формат>, <Положение>) – устанавливает новые значения параметров колонки (только те которые указаны). Если какой либо параметр при вызове метода не задан, то данный параметр колонки не изменяется.

Параметры:

<Колонка> – номер или идентификатор колонки, для которой будут установлены новые параметры.

<Тип> – необязательный параметр. Строка, описывающая тип колонки или вид субконто.

<Длина> – необязательный параметр. Длина для строковых и числовых значений.

<Точность> – необязательный параметр. Точность для числовых значений.

<3аголовок> – необязательный параметр. Заголовок колонки для показа.

<Ширина> – необязательный параметр. Ширина колонки в таблице.

<Формат> – необязательный параметр. Строковое выражение, содержащее форматную строку, которая будет использована при визуальном отображении значений данной колонки.

<Положение> – необязательный параметр. Определяет вариант выравнивания при визуальном отображении значений данной колонки: 1 – слева; 2 – справа.

Пример:

Табл.УстановитьПараметрыКолонки("Код", "Число", 6, 0, "Код", 6);

ПолучитьПараметрыКолонки(<Колонка>, <Тип>, <Длина>, <Точность>, <3аголовок>, <Ширина>, <Формат>, <Положение>) – возвращает значения параметров колонки по номеру колонки или по ее идентификатору.

Параметры:

<Колонка> – номер или идентификатор колонки, для которой требуется получить параметры.

<Тип> – необязательный параметр. Идентификатор переменной, в которую метод вернет строку, описывающую тип колонки.

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

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

<3аголовок> – необязательный параметр. Идентификатор переменной, в которую метод вернет строку, описывающую заголовок колонки для показа.

<Ширина> – необязательный параметр. Идентификатор переменной, в которую метод вернет ширину колонки в таблице.

<Формат>– необязательный параметр. Строковое выражение, содержащее форматную строку, которая будет использована при визуальном отображении значений данной колонки.

<Положение> – необязательный параметр. Определяет вариант выравнивания при визуальном отображении значений данной колонки: 1 – слева; 2 – справа.

Возвращаемое значение: номер или идентификатор колонки. Если в параметре <Колонка> задан номер колонки, то возвращается идентификатор колонки, и наоборот.

Пример:

Табл.ПолучитьПараметрыКолонки("Код", ВыбТип, ВыбДлина, ВыбТочность, ВыбЗаголовок, ВыбШирина);

КоличествоСтрок(<НовоеКоличествоСтрок>) – устанавливает/возвращает количество строк в таблице значений.

Параметры:

<НовоеКоличествоСтрок> – необязательный параметр. Новое количество строк в таблице значений.

Возвращаемое значение: количество строк в таблице значений до вызова метода.

Пример:

Разм = Табл.КоличествоСтрок();

НоваяСтрока(<НомерСтроки>) – вставляет новую строку в таблицу значений в указанную позицию.

Параметры:

<НомерСтроки> – необязательный параметр. Числовое выражение, содержащее позицию, в которую следует вставить новую строку.

Возвращаемое значение: номер новой строки.

Пример:

Табл.НоваяСтрока(1);

УдалитьСтроку(<НомерСтроки>) – удаляет строку из таблицы значений.

Параметры:

<НомерСтроки> – необязательный параметр. Номер строки. Если не указан, то удаляется текущая строка.

Пример:

Табл.УдалитьСтроку(2);

УдалитьСтроки() – удаляет все строки из таблицы значений.

Пример:

Табл.УдалитьСтроки();

ВыбратьСтроки() – предоставляет возможность перебирать строки таблицы значений (открывает выборку). Дальнейшая выборка осуществляется при помощи метода ПолучитьСтроку().

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

Возвращаемое значение: 1 – если строка выбрана успешно, 0 – если строка не выбрана (выборка закончилась).

Пример:

Табл.ВыбратьСтроки();

Пока Табл.ПолучитьСтроку() = 1 Цикл

...

КонецЦикла;

ВыбратьСтроку(<Строка>, <3аголовок>, < Таймаут>) – вызывает диалоговое окно для интерактивного выбора строки из заранее подготовленной таблицы значений. Параметр <Строка> указывает на ту строку таблицы значений, на которой будет установлен курсор при открытии окна выбора. В этот же параметр возвращается выбранное значение. Если выбор отменен, то значение параметров не меняются.

Параметры:

<Строка> – необязательный параметр. Идентификатор переменной, куда помещается значение – номер выбранной строки. При вызове метода здесь можно передавать значение начального номера строки.

<3аголовок> – необязательный параметр. Строковое выражение, значение которого отображается в заголовке диалогового окна. Может использоваться для подсказки пользователю.

<Таймаут> – необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя. Если не задано, то время ожидания бесконечно.

Возвращаемое значение: 1 – если выбор произведен (нажата кнопка «ОК»); 0 – если выбор не произведен (нажата кнопка «ОТМЕНА»); –1 (минус единица) – закончилось время <Таймаут> ожидания отклика пользователя.

Пример:

Перем НомСтроки;

Табл.ВыбратьСтроку(НомСтроки, "Выберите строку");

ПолучитьСтрокуПоНомеру(<НомерСтроки>) – получает строку таблицы значений по заданному номеру. Указанная строка становится текущей.

Параметры:

<НомерСтроки> – номер строки, на которую следует переместиться.

Пример:

Табл.ПолучитьСтрокуПоНомеру(3);

СдвинутьСтроку(<КоличествоСтрок>, <НомерСтроки>) – перемещает строку таблицы значений на новую позицию.

Параметры:

<КоличествоСтрок> – число строк, на которое надо переместить строку. Если число положительное, то строка сдвигается вниз, если отрицательное, то вверх.

<НомерСтроки> – необязательный параметр. Номер строки, которую надо переместить, если не задан, то текущая.

Возвращаемое значение: новая позиция строки

Пример:

Табл.СдвинутьСтроку(3, 5);

УстановитьЗначение(<Строка>, <Колонка>, <Знач>) – устанавливает значение конкретной колонки в данной строке таблицы значений.

Параметры:

<Строка> – номер строки.

<Колонка> – номер или идентификатор колонки.

<Знач> – устанавливаемое значение.

Пример:

Табл.УстановитьЗначение(3, 5, ВыбЗнач);

ПолучитьЗначение(<Строка>, <Колонка>) – получает значение конкретной колонки в данной строке таблицы значений.

Параметры:

<Строка> – номер строки.

<Колонка> – номер или идентификатор колонки.