Опубликовано: 06.04.2022

Служебные типы данных компоненты «Бухгалтерский учет»

Тип данных "ПланСчетов"

Тип данных "ПланСчетов" является служебным типом данных. Он предназначен для идентификации Плана счетов, созданного в метаданных.

В основном он используется для передачи в качестве параметра различным процедурам и функциям компоненты «Бухгалтерский учет» и для выбора плана счетов в формах. Тип значения "ПланСчетов" не поддерживает никаких данных в информационной базе, а список возможных значений этого типа данных определён планами счетов, созданными в конфигурации.

Значения типа "ПланСчетов" могут выступать как реквизиты диалога формы, как реквизиты документов, справочников и т.д.

Для получения значения такого типа данных используется глобальный атрибут ПланыСчетов, который имеет в свою очередь набор атрибутов типа "ПланСчетов" (в качестве имени конкретного атрибута выступает идентификатор конкретного плана счетов, имеющегося в конфигурации). Кроме того, глобальный атрибут ПланыСчетов имеет методы для обхода всех существующих планов счетов.

Методы типа данных "ПланСчетов"

Проверить факт выбора (наличия) значения типа "ПланСчетов" позволяет метод Выбран() (англоязычный синоним — Selected()). Параметры у метода отсутствуют. Возвращаемым значением метода будет число 1, если проверяемое значение не пустое, или 0, если значение пустое.

В нижеприведённом примере реквизит диалога «ИспПланСчетов», имеющий тип "ПланСчетов", проверяется на предмет выбора конкретного плана счетов пользователем:

Если ИспПланСчетов.Выбран() = 1 Тогда
   БухИтоги.ИспользоватьПланСчетов(ИспПланСчетов);
КонецЕсли;

Определить порядковый номер плана счетов в конфигурации позволяет метод ПорядковыйНомер() (англоязычный синоним — Number()). Параметры у метода отсутствуют. Возвращаемым значением метода будет числовое значение — порядковый номер плана счетов в конфигурации.

Пример использования:

Если ИспПланСчетов.Выбран() = 1 Тогда
   Сообщить("План счетов " + ИспПланСчетов.ПорядковыйНомер());
КонецЕсли;

Получить идентификатор плана счетов как он задан в метаданных позволяет метод Идентификатор() (англоязычный синоним — Identifier()). Параметры у метода отсутствуют. Возвращаемым значением метода будет строковое значение.

Пример использования:

Сч = СоздатьОбъект("Счет." + ВыбранныйПланСчетов().Идентификатор());

Примечание: В вышеприведённом пример используется встроенная системная функция ВыбранныйПланСчетов() компоненты «Бухгалтерский учет». Данная функция позволяет определить текущее значение параметра «Основной план счетов», выбранное пользователем при работе с системой.

Окно настройки параметров системы

Атрибут глобального контекста ПланыСчетов

Атрибут глобального контекста ПланыСчетов (англоязычный синоним — Charts0fAccounts) не имеет самостоятельного смысла, а служит для получения конкретных значений типа "ПланСчетов". Атрибут всегда используется с доступными ему атрибутами и методами. Например, для получения конкретного значения типа "ПланСчетов" следует через точку указать атрибут — идентификатор плана счетов, а для получения количества существующих в конфигурации планов счетов следует через точку вызвать метод КоличествоЗначений():

Сч = СоздатьОбъект("Счет");

    . . .

Если Сч.ПланСчетов() = ПланыСчетов.РабочийПлан Тогда
    . . .
КонецЕсли;

Для Инд=1 По ПланыСчетов.КоличествоЗначений() Цикл
   ПлСч = ПланыСчетов.ЗначениеПоНомеру(Инд);
    . . .
КонецЦикла;

Методы глобального атрибута ПланыСчетов

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

Пример использования:

Для Инд=1 По ПланыСчетов.КоличествоЗначений() Цикл
   ПлСч = ПланыСчетов.ЗначениеПоНомеру(Инд);
    . . .
КонецЦикла;

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

Синтаксис метода:

ЗначениеПоНомеру(<Номер>)

где <Номер> — числовое выражение — номер позиции плана счетов, заданный в Конфигураторе.

Пример использования:

Для Инд=1 По ПланыСчетов.КоличествоЗначений() Цикл
   ПлСч = ПланыСчетов.ЗначениеПоНомеру(Инд);
    . . .
КонецЦикла;

Определить план счетов по идентификатору, заданному в конфигурации, позволяет метод ЗначениеПоИдентификатору() (англоязычный синоним — ValueByIdentifier()) атрибута глобального контекста ПланыСчетов. Возвращаемым значением метода будет значение типа "ПланСчетов", соответствующее идентификатору в метаданных. Если же план счетов с таким идентификатором не найден, то возвращаемым значением будет пустое значение.

Синтаксис метода:

ЗначениеПоИдентификатору(<Идентификатор>)

где <Идентификатор> — строковое выражение — идентификатор плана счетов, заданный в Конфигураторе.

Пример использования:

ПлСч = ПланыСчетов.ЗначениеПоИдентификатору("Основной");

Тип данных "ВидСубконто"

Тип данных "ВидСубконто" является служебным типом данных. Он предназначен для идентификации самого вида субконто, созданного в метаданных.

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

Значения типа "ВидСубконто" могут выступать как реквизиты диалога формы, как реквизиты документов, справочников и т.д.

Для получения значения такого типа используется глобальный атрибут ВидыСубконто, который имеет в свою очередь набор атрибутов типа "ВидСубконто" соответствующих имеющимся видам субконто. Кроме того, глобальный атрибут ВидыСубконто имеет методы для обхода всех существующих видов субконто.

Методы типа данных "ВидСубконто"

Проверить факт выбора (наличия) значения типа "ВидСубконто" позволяет метод Выбран() (англоязычный синоним — Selected()). Параметры у метода отсутствуют. Возвращаемым значением метода будет число 1, если проверяемое значение не пустое, или 0, если значение пустое.

В нижеприведённом примере реквизит диалога «ВыбВидСубк1», имеющий тип "ВидСубконто", проверяется на предмет выбора вида субконто пользователем:

Если ВыбВидСубк1.Выбран() = 1 Тогда
   БухИтоги.ИспользоватьСубконто(ВыбВидСубк1);
КонецЕсли;

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

Пример использования:

Если ВыбВидСубк1.Выбран() = 1 Тогда
   Сообщить("Вид субконто N " + ВыбВидСубк1.ПорядковыйНомер());
КонецЕсли;

Получить строку-идентификатор вида субконто, как он задан в метаданных, позволяет метод Идентификатор() (англоязычный синоним — Identifier()). Параметры у метода отсутствуют. Возвращаемым значением метода будет строковое значение.

Пример использования:

ВидСубконто = Корреспонденция.Счет.ВидСубконто(НомерСубконто).Идентификатор();

Определить тип субконто позволяет метод ТипСубконто() (англоязычный синоним — SubcontoType()). Параметры у метода отсутствуют. Возвращаемым значением метода будет строковое значение, описывающее тип субконто, например "Справочник.Контрагенты".

Пример использования:

Сообщить("Тип субконто " + ВыбВидСубк1.ТипСубконто());

Атрибут глобального контекста ВидыСубконто

Атрибут глобального контекста ВидыСубконто (англоязычный синоним — SubcontoKinds) не имеет самостоятельного смысла, а служит для получения конкретных значений типа "ВидСубконто". Атрибут всегда используется с доступными ему атрибутами и методами. Например, для получения конкретного значения типа "ВидСубконто" следует через точку указать атрибут — идентификатор вида субконто, а для получения количества существующих в конфигурации видов субконто следует через точку вызвать метод КоличествоЗначений():

Сч = СоздатьОбъект("Счет");
Если Сч.ВидСубконто(1) = ВидыСубконто.Материалы Тогда
    . . .
КонецЕсли;

Для Инд=1 По ВидыСубконто.КоличествоЗначений() Цикл
   ВидСк = ВидыСубконто.ЗначениеПоНомеру(Инд);
КонецЦикла;

Методы глобального атрибута ВидыСубконто

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

Пример использования:

Для Инд=1 По ВидыСубконто.КоличествоЗначений() Цикл
   ВидСк = ВидыСубконто.ЗначениеПоНомеру(Инд);
КонецЦикла;

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

Синтаксис метода:

ЗначениеПоНомеру(<Номер>)

где <Номер> — числовое выражение — номер позиции вида субконто, заданный в Конфигураторе.

Пример использования:

Для Инд=1 По ВидыСубконто.КоличествоЗначений() Цикл
   ВидСк = ВидыСубконто.ЗначениеПоНомеру(Инд);
КонецЦикла;

Определить вид субконто, соответствующий идентификатору вида субконто конфигурации, позволяет метод ЗначениеПоИдентификатору() (англоязычный синоним — ValueByIdentifier()) атрибута глобального контекста ВидыСубконто. Возвращаемым значением метода будет значение типа "ВидСубконто", соответствующее идентификатору в метаданных. Если же вид субконто с таким идентификатором не найден, то возвращаемым значением будет пустое значение.

Синтаксис:

ЗначениеПоИдентификатору(<Идентификатор>)

где <Идентификатор> — строковое выражение — идентификатор вида субконто, заданный в конфигураторе.

Пример использования:

ВидСк = ВидыСубконто.ЗначениеПоИдентификатору("Контрагент");

Другие статьи по схожей тематике