Контекст выполнения программного модуля

24.3 Контекст выполнения программного модуля

Каждый программный модуль связан с остальной частью конфигурации задачи. Эта связь называется контекстом выполнения модуля. Следует различать два вида контекста:

-  глобальный контекст задачи;

-  локальный контекст выполнения конкретного модуля.

Глобальный контекст образуется:

-  значениями системных атрибутов, системными процедурами и функциями;

-  значениями заданных в конфигураторе констант, перечислений, регистров, видов расчета, групп видов расчета;

-  переменными, процедурами и функциями глобального программного модуля, объявленными с ключевым словом Экспорт.

Глобальный контекст виден всем программным модулям и определяет общую языковую среду конфигурации.

Локальный контекст модуля образуется тем конкретным местом конфигурации задачи, для которого использован программный модуль. Локальный контекст виден только конкретному программному модулю и определяет для модуля набор непосредственно доступных модулю значений агрегатных типов данных, их атрибутов и методов (см. «Виды программных модулей»). Однако контекст модуля можно передать как объект в виде параметра при вызове процедур и функций (см. «Передача локального контекста программного модуля в качестве параметра»). Кроме того, контекст модуля определяет тот набор методов, которые доступны только в данном контексте (см. «Атрибуты и методы контекста Модуля формы», «Методы контекста Модуля формы элемента справочника» и т. п.). Локальный контекст предназначен для того, чтобы дать возможность управлять частными аспектами поведения задачи, присущими данному модулю.

  24.5 Виды программных модулей

В системе 1С: Предприятие существуют следующие виды программных модулей (места размещения программных модулей в конфигурации задачи), доступных в конфигураторе:

Размещение	Момент запуска		Контекст выполнения
Глобальный модуль
Размещается в корневом разделе конфигурации: Метаданные.	Запускается при старте всей прикладной задачи.		Глобальный модуль определяет глобальный контекст всей задачи.
Модуль Формы списка справочника
Размещается в разделе конфигурации: Метаданные — Справочник — Форма списка.	Запускается при вызове формы списка справочника.		В модуле доступны: глобальный контекст, контекст Модуля формы списка справочника, в котором непосредственно доступен выбранный в списке элемент справочника и реквизиты формы списка справочника.
Модуль Формы группы справочника
Размещается в разделе конфигурации: Метаданные — Справочник — Форма группы.	Запускается при открытии формы группы справочника.		В модуле доступны: глобальный контекст, контекст Модуля формы группы справочника, в котором непосредственно доступны реквизиты текущей группы справочника и реквизиты формы.
Модуль Формы элемента справочника
Размещается в разделе конфигурации: Метаданные — Справочник — Форма элемента.	Запускается при открытии формы элемента справочника.		В модуле доступны: глобальный контекст, контекст Модуля формы элемента справочника, в котором непосредственно доступны реквизиты текущего элемента справочника и реквизиты формы.
Модуль Формы документа
Размещается в разделе конфигурации: Метаданные — Документ — Форма.	Запускается при открытии формы документа.		В модуле доступны: глобальный контекст, контекст Модуля формы документа, в котором непосредственно доступны реквизиты текущего документа и реквизиты формы документа.
Модуль документа
Размещается в разделе конфигурации: Метаданные — Документ — Модуль документа.	Запускается при проведении документа, при удалении проведенного документа, при снятии проведения, при выполнении архивации записей журнала расчетов, порожденных документом.		В модуле доступны: глобальный контекст, контекст Модуля документа, в котором непосредственно доступны реквизиты текущего документа.
Модуль Формы журнала документов
Размещается в разделе конфигурации: Метаданные — Журнал — Форма.	Запускается при вызове формы журнала документов.		В модуле доступны: глобальный контекст, контекст Модуля формы журнала документов, в котором непосредственно доступен выбранный в журнале документ и реквизиты формы журнала.
Модуль Формы журнала расчетов
Размещается в разделе конфигурации: Метаданные — Журнал расчетов — Форма.	Запускается при вызове формы журнала расчетов.		В модуле доступны: глобальный контекст, контекст Модуля формы журнала расчетов, в котором непосредственно доступны реквизиты журнала расчетов и реквизиты формы.
Модуль Формы списка счетов
Размещается в разделе конфигурации: Метаданные — План счетов.		Запускается при вызове формы списка счетов.		В модуле доступны: глобальный контекст, контекст Модуля формы списка счетов, в котором непосредственно доступен выбранный в списке счет и реквизиты формы списка счетов.
Модуль Формы счета
Размещается в разделе конфигурации: Метаданные — Справочник — счет.		Запускается при открытии формы счета.		В модуле доступны: глобальный контекст, контекст Модуля формы счета, в котором непосредственно доступны реквизиты текущего счета и реквизиты формы.
Модуль Формы журнала операций
Размещается в разделе конфигурации: Метаданные — Журнал операций — Форма.		Запускается при вызове формы журнала операций.		В модуле доступны: глобальный контекст, контекст Модуля формы журнала операций, в котором непосредственно доступны реквизиты журнала операций и реквизиты формы.
Модуль Формы операции
Размещается в разделе конфигурации: Метаданные — Операция.		Запускается при открытии формы операции.		В модуле доступны: глобальный контекст, контекст Модуля формы операции, в котором непосредственно доступны реквизиты текущей операции и реквизиты формы операции.
Модуль Формы журнала проводок
Размещается в разделе конфигурации: Метаданные — Журнал проводок — Форма.	Запускается при вызове формы журнала проводок.		В модуле доступны: глобальный контекст, контекст Модуля формы журнала проводок, в котором непосредственно доступны реквизиты журнала проводок и реквизиты формы.
Модуль Формы отчета
Размещается в разделе конфигуратора: Метаданные — Отчет — Форма.	Запускается при открытии диалоговой формы подготовки отчета.		В модуле доступны: глобальный контекст, контекст Модуля формы отчета, в котором непосредственно доступны реквизиты формы.
Модуль Формы обработки
Размещается в разделе конфигуратора: Метаданные — Обработка — Форма.	Запускается при открытии диалоговой формы обработки.		В модуле доступны: глобальный контекст, контекст Модуля формы обработки, в котором непосредственно доступны реквизиты формы.
Модуль вида расчета
Размещается в разделе конфигуратора: Метаданные — Вид расчета — Модуль вида расчета.	Запускается при расчете соответствующих записей журнала расчетов.		В модуле доступны: глобальный контекст, контекст Модуля вида расчета, в котором доступны реквизиты

24.6 Описания элементов языка

В программах 1С: Предприятие существующие элементы (конструкции) языка можно разделить на:

-  Структурные конструкции

-  Системные конструкции

-  Управляющие операторы

-  Выражения и операторы присваивания

-  Системные константы

-  Системные процедуры и функции

-  Системные предопределенные процедуры

Мы рассмотрим «структурные конструкции и управляющие операторы»

-  Структурные конструкции

-  Процедура

-  Секция описания процедуры.

Синтаксис:

Процедура <Имя_проц>([[Знач] <Парам1>[=<ДефЗнач>],

... , [Знач] <ПapaмN>[=<ДeфЗнaч>]]) [Экспорт]

//Объявления локальных переменных;

//Операторы;

...

[Возврат;]

//Операторы;

...

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

Параметры:

<Имя_проц>	Назначает имя процедуры.
Знач	Необязательное ключевое слово, которое указывает на то, что следующий за ним параметр передается по значению, т. е. изменение значения формального параметра при выполнении процедуры никак не повлияет на фактический параметр, переданный при вызове процедуры. Если это ключевое слово не указано, то параметр процедуры передается по ссылке, то есть изменение внутри процедуры значения формального параметра приведет к изменению значения соответствующего фактического параметра.
<Парам1>, ..., <ПарамN>	Необязательный список формальных параметров, разделяемых запятыми. Значения формальных параметров должны соответствовать значениям передаваемых при вызове процедуры фактических параметров. В этом списке определяются имена каждого из параметров так, как они используются в тексте процедуры. Список формальных параметров может быть пуст. См. также: «Передача параметров».
=<ДефЗнач>	Необязательная установка значения параметра по умолчанию. Параметры с установленными значениями по умолчанию можно располагать в любом месте списка формальных параметров. Если параметр при вызове процедуры опущен, то он принимает либо установленное по умолчанию значение (если оно есть) либо принимает «пустое» значение (значение неопределенного типа). Если параметру не задано значение по умолчанию, и он является последним в списке передаваемых параметров, то при вызове процедуры его нельзя опускать. Если параметру задано значение по умолчанию, и он является последним в списке, то при вызове процедуры его можно опускать в списке передаваемых фактических параметров и не ставить запятую перед опущенным параметром. Если параметру не задано значения по умолчанию, то при вызове процедуры его можно опускать в списке передаваемых фактических параметров, но разделительную запятую надо ставить.
Экспорт	Необязательное ключевое слово, которое указывает на то, что данная процедура является доступной из других программных модулей. Имеет смысл только в глобальном программном модуле.
//Объявления локальных переменных	Объявляются локальные переменные, на которые можно ссылаться только в рамках этой процедуры (см. оператор Перем).
//Операторы	Исполняемые операторы процедуры.
Возврат	Необязательное ключевое слово, которое завершает выполнение процедуры и осуществляет возврат в точку программы, из которой было обращение к процедуре. Использование данного оператора в процедуре не обязательно.
КонецПроцедуры	Обязательное ключевое слово, обозначающее конец исходного текста процедуры, завершение выполнения процедуры. Возврат в точку, из которой было обращение к процедуре.

Описание:

Ключевое слово Процедура начинает секцию исходного текста, выполнение которого можно инициировать из любой точки программного модуля, просто указав Имя_процедуры со списком параметров (если параметры не передаются, то круглые скобки, тем не менее, обязательны). Если в глобальном программном модуле в теле описания функции использовано ключевое слово Экспорт, то это означает, что данная процедура является доступной из всех других программных модулей конфигурации. Ключевое слово Экспорт имеет смысл использовать только в глобальном программном модуле.

Функция

Секция описания функции.

Синтаксис:

Функция<Имя_функции>([[Знач]<Парам1>[=<ДефЗнач>], ...

,[Знач]<ПарамN>[=<ДефЗнач>]])[Экспорт]

//Объявлениялокальных переменных;

//Операторы;

...

Возврат<ВозвращаемоеЗначение>;

//Операторы;

...

КонецФункции

Параметры:

<Имя_функции>	Назначает имя функции.
Знач	Необязательное ключевое слово, которое указывает на то, что следующий за ним параметр передается по значению, т.е. изменение значения формального параметра при выполнении функции никак не повлияет на значение фактического параметра, переданного при вызове функции. Если это ключевое слово не указано, то параметр функции передается по ссылке, то есть изменение внутри функции значения формального параметра приведет к изменению значения соответствующего фактического параметра.
<Парам1>,...,<ПарамN>	Необязательный список формальных параметров, разделяемых запятыми. Значения формальных параметров должны соответствовать значениям передаваемых при вызове функции фактических параметров. В этом списке определяются имена каждого из параметров так, как они используются в тексте функции. Список формальных параметров может быть пуст.
=<ДефЗнач>	Необязательная установка значения параметра по умолчанию. Параметры с установленными значениями по умолчанию можно располагать в любом месте списка формальных параметров. Если параметр при вызове процедуры опущен, то он принимает либо установленное по умолчанию значение (если оно есть) либо принимает «пустое»значение (значение неопределенного типа). Если параметру не задано значение по умолчанию, и он является последним в списке передаваемых параметров, то при вызове процедуры его нельзя опускать. Если параметру задано значение по умолчанию, и он является последним в списке, то при вызове процедуры его можно опускать в списке передаваемых фактических параметров и не ставить запятую перед опущенным параметром. Если параметру не задано значения по умолчанию, то при вызове процедуры его можно опускать в списке передаваемых фактических параметров, но разделительную запятую надо ставить.
Экспорт	Необязательное ключевое слово, которое указывает на то, что данная функция является доступной из других программных модулей. Данное ключевое слово имеет смысл использовать только в глобальном программном модуле.
//Объявлениялокальных переменных	Объявляются локальные переменные, на которые можно ссылаться только в рамках этой функции.
//Операторы	Исполняемые операторы функции.
Возврат	Ключевое слово, которое завершает выполнение функции и возвращает Возвращаемое Значение в выражение, в котором используется функция. Использование данного ключевого слова в функции обязательно.
<ВозвращаемоеЗначение>	Выражение, значение которого содержит результат обращения к функции.
КонецФункции	Обязательное ключевое слово, обозначающее конец исходного текста функции.

Описание

Ключевое слово Функция начинает секцию исходного текста функции, выполнение которой можно инициировать из любой точки программного модуля, просто указав Имя_функции со списком параметров (если параметры не передаются, то круглые скобки, тем не менее, обязательны). Если в глобальном программном модуле в теле описания функции использовано ключевое слово Экспорт, то это означает, что данная функция является доступной из всех других программных модулей конфигурации. Ключевое слово Экспорт имеет смысл использовать только в глобальном программном модуле.

Выполнение функции заканчивается обязательным оператором Возврат. Функции отличаются от процедур только тем, что возвращают Возвращаемое Значение. Конец программной секции функции определяется по оператору КонецФункции.

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

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

Управляющие операторы

Если

Оператор условного выполнения.

Синтаксис:

Если <Логическое_выражение> Тогда

//операторы;

[ИначеЕсли <Логическое_выражение> Тогда]

//операторы;

[Иначе]

//операторы;

КонецЕсли;

<Логическое_выражение>	Логическое выражение.
Тогда	Операторы следующие за Тогда выполняются, если результатом логического выражения в конструкции Если является истина.
//операторы	Исполняемый оператор или последовательность таких операторов.
ИначеЕсли	Логическое выражение, следующее за ключевым словом ИначеЕсли вычисляется только тогда, когда условия в Если и всех предшествующих ИначеЕсли оказались ложными. Операторы следующие за конструкцией ИначеЕсли — Тогда выполняются, если результатом логического выражения в данном ИначеЕсли является истина.
Иначе	Операторы, следующие за ключевым словом Иначе выполняются, если результаты логических выражений в конструкции Если и всех предшествующих конструкциях ИначеЕсли оказались ложными.
КонецЕсли	Ключевое слово, которое завершает структуру оператора условного выполнения.

Описание:

Оператор Если управляет выполнением программы, основываясь на результате одного или более логических выражений. Оператор может содержать любое количество групп операторов, возглавляемых конструкциями

ИначеЕсли — Тогда.

Пока

Оператор выполнения цикла.

Синтаксис:

Пока <Логическое_выражение> Цикл

//операторы;

КонецЦикла;

Параметры:

<Логическое_выражение>	Логическое выражение.
Цикл	Операторы, следующие за ключевым словом Цикл, выполняются, пока результатом логического выражения является истина.
//операторы;	Исполняемый оператор или последовательность таких операторов.
КонецЦикла	Ключевое слово, которое завершает структуру оператора цикла.

Описание:

Оператор цикла Пока предназначен для циклического повторения операторов, находящиеся внутри конструкции Цикл ... КонецЦикла. Цикл выполняется пока логическое выражение — истина. Условие выполнения цикла всегда проверяется вначале, перед выполнением цикла.

Для

Оператор выполнения цикла.

Синтаксис:

Для <Имя_переменной> = <Выражение1> По <Выражение2> Цикл

//Операторы;

КонецЦикла;

Параметры:

<Имя_переменной>	Идентификатор переменной (счетчика цикла), значение которой автоматически увеличивается при каждом повторении цикла.
<Выражение 1>	Числовое выражение, которое задает начальное значение, присваиваемое счетчику цикла при первом проходе цикла.
По	Синтаксическая связка для параметра <Выражение2>.
<Выражение 2>	Максимальное значение счетчика цикла. Когда переменная Имя_переменной становится больше чем <Выражение2>, выполнение оператора цикла Для прекращается. Величина приращения счетчика при каждом выполнении цикла равна 1.
Цикл	Операторы следующие за ключевым словом Цикл выполняются, пока значение переменной Имя_переменной меньше значения <Выражение2>.
//Операторы	Исполняемый оператор или последовательность таких операторов.
КонецЦикла	Ключевое слово, которое завершает структуру оператора цикла.

Описание

Оператор цикла Для предназначен для циклического повторения операторов, находящиеся внутри конструкции Цикл ... КонецЦикла. Перед началом выполнения цикла значение <Выражение1> присваивается переменной <Имя_переменной>. Значение <Имя_переменной> автоматически увеличивается при каждом проходе цикла. Цикл выполняется пока значение переменной <Имя_переменной> меньше или равно значению <Выражение2>. Величина приращения счетчика при каждом выполнении цикла равна 1. Условие выполнения цикла всегда проверяется вначале, перед выполнением цикла.

Попытка

Обработка исключительных ситуаций.

Синтаксис:

Попытка

// Некоторые действия;

Исключение

// Обработка исключительной ситуации;

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

Параметры:

// Некоторые действия	Исполняемый оператор или последовательность таких операторов.
// Обработка исключительной ситуации	Исполняемый оператор или последовательность операторов, которые обрабатывают исключительную ситуацию.
Исключение	Операторы, следующие за ключевым словом Исключение выполняются, если при выполнении последовательности операторов <// Некоторые действия> произошла ошибка времени выполнения.
Конец Попытки	Ключевое слово, которое завершает структуру оператора обработки исключительных ситуаций.

Описание

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

В качестве ошибочных (исключительных) ситуаций воспринимаются ошибки времени выполнения модуля. Не предусмотрено определяемых пользователем исключений.

Если при выполнении последовательности операторов <// Некоторые действия> произошла ошибка времени выполнения, то выполнение оператора, вызвавшего ошибку прерывается и управление передается на первый оператор последовательности операторов <// Обработка исключительной ситуации>. При этом управление будет передано даже в том случае, если ошибку вызвал оператор, находящийся в процедуре или функции, вызванной из <// Некоторые действия>. Если ошибка произошла в вызванной процедуре или функции, то ее выполнение будет прервано, а локальные переменные уничтожены. Это справедливо для любой вложенности вызовов. После выполнения последовательности операторов <// Обработка исключительной ситуации> управление передается на следующий за ключевым словом Конец Попытки оператор. Если же последовательность <// Некоторые действия> выполнилась без ошибок, то последовательность операторов <// Обработка исключительной ситуации> будет пропущена и управление также будет продолжено с оператора, следующего за ключевым словом Конец Попытки.

Конструкции Попытка-Исключение-Конец Попытки могут быть вложенными. При этом, при возникновении исключительной ситуации управление будет передано на самый «внутренний» обработчик, начинающийся с ключевого слова Исключение. Последовательность операторов <// Обработка исключительной ситуации> может содержать оператор Вызвать Исключение (англоязычный синоним Raise). Выполнение данного оператора прекращает выполнение последовательности <// Обработка исключительной ситуации> и производится поиск более «внешнего» обработчика. Если таковой есть, то управление передается на его первый оператор. Если нет, то выполнение модуля прекращается с выдачей сообщения о первоначально возникшей ошибке. Оператор Вызвать Исключение может встречаться только внутри операторных скобок Исключение ... Конец Попытки.

В выдаче диагностики помощь может оказать встроенная функция Описание Ошибки () (англоязычный синоним Get Error Description). Эта функция не имеет параметров, а в качестве значения возвращает описание ошибки, такое же, как было бы выдано в окне сообщений, в случае отсутствия обработчика исключительной ситуации, за исключением описания модуля и строки, в которой ошибка возникла. Применять данную функцию имеет смысл только при выполнении последовательности операторов <// Обработка исключительной ситуации>, так как в ином случае она вернет пустую строку.

Перейти

Безусловная передача управления на другой оператор программы.

Синтаксис:

Перейти <Метка>;

Параметры:

<Метка>

Метка другого исполняемого оператора в программе.

Описание:

Безусловная передача управления на другой оператор программы. Оператор Перейти передает управление от одного оператора к другому. <Метка> в этом операторе не должна быть меткой перехода на оператор Процедура или Функция.

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

Оператор безусловного перехода не может быть использован для передачи управления на операторы, находящиеся внутри конструкций: Пока ... Конец Цикла, Для ... Конец Цикла, Если ... Иначе Если ... Иначе ... Конец Если, Попытка ... Исключение ... Конец Попытки извне этих конструкций.

Продолжить

Передача управления в начало цикла.

Описание:

Передает управление в начало цикла. Оператор Продолжить немедленно передает управление в начало цикла, где производится вычисление и проверка условий выполнения цикла. Оператор Продолжить может использоваться только внутри конструкций операторов цикла Пока и Для.

Прервать

Прерывает выполнение цикла.

Синтаксис:

Прервать

Описание:

Прерывает выполнение цикла. Оператор Прервать приводит к немедленному прекращению выполнения цикла и передает управление первому оператору, следующему за конструкцией оператора Пока или Для. Оператор Прервать может использоваться только внутри конструкций операторов цикла Пока и Для.

Возврат

Завершение процедуры или функции.

Синтаксис:

Возврат [<Выражение>]

Параметры:

<Выражение>

Выражение, значение которого содержит результат обращения к функции. Этот параметр обязателен для оператора Возврат в теле описания функции, но не может использоваться в процедуре.

Оператор Возврат завершает выполнение процедуры или функции и передает управление в вызвавшую точку программы. Оператор Возврат обязателен в функции и необязателен в процедуре. Если в процедуре не используется оператор Возврат, то его неявное выполнение происходит вслед за последним исполняемым оператором процедуры. Данный оператор может применяться только в теле описания процедуры или функции, причем <Выражение> может задаваться только в случае использования оператора в контексте функции.

Символы

Символ	Значение
[ ]	В квадратных скобках заключаются необязательные синтаксические элементы.
( )	Круглые скобки заключают в себе список параметров.
|	Вертикальной линией разделяются синтаксические элементы, среди которых нужно выбрать только один.

 

Специальные символы, используемые в исходном тексте

//	Двумя знаками «косая черта» начинается комментарий. Комментарием считается весь текст от знака "//" до конца текущей строки.
|	Вертикальная черта в начале строки используется только в строковых константах и означает, что данная строка является продолжением предыдущей (перенос строки), (см. «Строковые константы»).
~	Знаком тильда начинается метка оператора.
:	Двоеточием заканчивается метка оператора.
;	Точка с запятой является символом разделения операторов.
( )	В круглые скобки заключается список параметров методов, процедур и функций.
[ ]	В квадратные скобки заключается размерность массивов.
,	Запятая разделяет параметры в списке параметров методов, процедур и функций.
" "	В двойные кавычки заключаются строковые константы.
' '	В одинарные кавычки заключаются константы даты.
.	Десятичная точка в числовых константах. Разделитель, используемый в описаниях агрегатных типов данных.
+	Символ «плюс» обозначает операцию сложения.
-	Символ «минус» обозначает операцию вычитания.
*	Символ «звездочка» обозначает операцию умножения.
/	Символ «косая черта» обозначает операцию деления.
>	Правая угловая скобка обозначает логическую операцию «больше».
>=	Логическая операция «больше или равно».
<	Левая угловая скобка обозначает логическую операцию «меньше».
<=	Логическая операция «меньше или равно».
=	Знак равенства обозначает присвоение или логическую операцию «равно».
<>	Две угловые скобки обозначают логическую операцию «не равно».

Пример

Рассмотрим часть модуля документа «Счет» в программе «1С: Бухгалтерия»

Процедура «Печать» - создание печатной формы документа.

Процедура Печать()

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

ИмяФайлаПечатнойФормы = КаталогИБ()+"ExtForms\PrnForms\1cbs.mxl";

Если ФС.СуществуетФайл(ИмяФайлаПечатнойФормы) = 1 Тогда

Таб.ИсходнаяТаблица(ИмяФайлаПечатнойФормы);

Иначе

Таб.ИсходнаяТаблица("Таблица");

КонецЕсли;

Таб.ВывестиСекцию("Шапка");

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

Ном = 0;

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

Ном = Ном + 1;

Таб.ВывестиСекцию("Строка");

КонецЦикла;

Таб.ВывестиСекцию("Итого");

Таб.ВывестиСекцию("НДС");

Если УчитыватьНП = 1 Тогда

Таб.ВывестиСекцию("НП");

КонецЕсли;

Таб.ВывестиСекцию("Подвал");

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

Процедура «Ввод на основании» - документ будет выводиться на основании другого документа.

Процедура ВводНаОсновании(ДокОсн) //предопределенная

Новый = 1;

Если ДокОсн.Вид() = "РасходнаяНакладная" Тогда

РасчетныйСчет = ДокОсн.РасчетныйСчет;

Контрагент = ДокОсн.Контрагент;

Договор = ДокОсн.Договор;

Плательщик = ДокОсн.Контрагент;

ВариантРасчетаНалогов = ДокОсн.ВариантРасчетаНалогов;

ДокОсн.ВыбратьСтроки();

Пока ДокОсн.ПолучитьСтроку() = 1 Цикл

НоваяСтрока();

Товар = ДокОсн.Товар;

Количество = ДокОсн.Количество;

Цена = ДокОсн.Цена;

Сумма = ДокОсн.Сумма;

НДС = ДокОсн.НДС;

НП = ДокОсн.НП;

Всего = ДокОсн.Всего;

КонецЦикла;

КонецЕсли;

КонецПроцедуры //ВводНаОсновании

Средства администрирования

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

25 Аутентификация

Механизм аутентификации позволяет определить, кто именно из пользователей, перечисленных в списке пользователей системы, подключается к прикладному решению в данный момент.

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

аутентификация средствами 1С:Предприятия;

аутентификация средствами Windows.

  25.1 Аутентификация средствами 1С:Предприятия

Для выполнения аутентификации средствами 1С:Предприятия пользователь, при начале работы с прикладным решением, должен выбрать (или ввести) имя пользователя и соответствующий этому имени пароль:

Если пароль, введенный пользователем, не соответствует тому, который хранится в информационной базе, доступ к прикладному решению будет закрыт:

25.2 Аутентификация средствами Windows

При выполнении аутентификации средствами Windows, от пользователя не требуется каких-либо действий по вводу логина и пароля. Система анализирует, от имени какого Windows-пользователя выполняется подключение к прикладному решению, и на основании этого определяет соответствующего пользователя 1С:Предприятия. При этом диалог аутентификации 1С:Предприятия не отображается, если не указан специальный параметр командной строки. Аутентификацию средствами Windows имеет смысл использовать для NT-подобных операционных систем, например NT, 2000, XP.

Если для пользователя не указан ни один из видов аутентификации, - такому пользователю доступ к прикладному решению закрыт.

  25.3 Список пользователей

Система 1С:Предприятие позволяет вести список пользователей, которым разрешена работа с системой. Этот список не является частью прикладного решения, а создается отдельно в конкретной организации, в которой используется система:

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

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

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

  25.4 Активные пользователи

Список активных пользователей позволяет получать информацию о том, кто из пользователей работает с информационной базой в данный момент:

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

25.5 Журнал регистрации

Журнал регистрации содержит информацию о том, какие события происходили в информационной базе в определенный момент времени или какие действия выполнял тот или иной пользователь:

Журнал регистрации доступен как в режиме 1С:Предприятие, так и в режиме Конфигуратор.

В режиме 1С: Предприятие по щелчку мыши в полях Данные и Представление данных можно перейти к тому объекту прикладного решения, который указан в записи журнала регистрации.

Информацию, находящуюся в журнале регистрации, можно отбирать по большому количеству критериев. Например, можно отобрать только информацию о том, какие документы изменялись определенным пользователем в заданный промежуток времени:

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

Существует возможность настройки уровня событий, отображаемых в журнале регистрации:

Кроме этого разработчик может самостоятельно добавлять записи в журнал регистрации, используя средства встроенного языка. Такая возможность позволяет настраивать журнал регистрации под нужды конкретного прикладного решения.

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

Используя средства работы со списками, разработчик имеет возможность выгрузить журнал регистрации в текстовый или табличный документ, который в дальнейшем может быть сохранен в собственном формате или, например, формате листа Excel или документа HTML.

26. Загрузка и выгрузка информационной базы

Текущая информационная база может быть выгружена в файл на диске или загружена из файла. Эти операции могут использоваться, например, для создания архива информационной базы и восстановления какой-либо копии базы из архива. Также выгрузка и загрузка информационной базы используется для переноса базы из файлового варианта в клиент серверный и обратно.

При загрузке и выгрузке информационной базы система открывает стандартный диалог выбора файла.

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

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

Тестирование и исправление информационной базы

Процедура тестирования и исправления информационной базы служит для диагностики и устранения ошибочных состояний информационных баз, имеющих различный формат хранения данных (файловый или клиент-серверный):

,

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

Имеется возможность выполнять только тестирование или тестирование с исправлением. Причем, возможен выбор нескольких вариантов исправления конфликтных ситуаций.

Следует заметить, что тестирование и исправление информационной базы может выполняться только в монопольном режиме (т.е. работа пользователей с информационной базой в процессе тестирования и исправления невозможна).

26.1 Региональные установки информационной базы

Настройка региональных установок информационной базы позволяет управлять форматом отображения даты, времени, чисел и логических констант в прикладном решении:

,

Если ни одно из свойств в данном диалоге установлено не будет, то язык и форматы отображения чисел, даты и времени будут определяться настройками операционной системы.

В нижней части окна содержатся примеры отображения числа, даты и времени в соответствии с выбранными настройками.

Обновление конфигурации

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

В этих случаях администратор информационной базы может выполнить обновление конфигурации прикладного решения.

  26.2 Обновление конфигурации, находящейся на поддержке

В случае если текущая конфигурация находится на поддержке у одного или нескольких поставщиков, администратор может выполнить обновление текущей конфигурации до конфигурации поставщика.

Обновление технологической платформы

Новые релизы 1С:Предприятия 8.0 выпускаются в виде дистрибутива или в виде дистрибутива обновления (поставляемого на диске информационно-технологического сопровождения - ИТС). Обновление технологической платформы может быть выполнено с использованием обоих видов дистрибутивов.

26.3 Обновление технологической платформы при обычной установке 1С:Предприятия

Для выполнения обновления технологической платформы необходимо запустить программу установки, входящую в состав дистрибутива. Будет произведен анализ установленного 1С:Предприятия и в случае, если текущая версия платформы не требует обновления, работы программы установки будет завершена; иначе будет выполнено обновление установленных компонент технологической платформы.

При работе в клиент-серверном варианте следует помнить, что работа клиентского и серверного приложений разных версий не допускается, поэтому необходимо выполнять обновление как серверного приложения, как и клиентских приложений.

  26.4 Обновление технологической платформы при административной установке 1С:Предприятия

Если была выполнена административная установка 1С:Предприятия 8.0 (для использования в локальной сети), администратор получает возможность выполнять обновление технологической платформы только в одном месте - в месте административной установки. Дальнейшее обновление версий платформы на локальных компьютерах смогут произвести сами пользователи.

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

27  Утилита администрирования клиент-серверного варианта

Утилита администрирования клиент-серверного варианта предназначена для решения следующих задач:

мониторинг серверов 1С:Предприятия;

просмотр списка информационных баз;

создание и удаление информационных баз;

мониторинг соединений пользователей с информационными базами;

отключение пользователей от информационной базы:

Утилита представляет собой подключаемый модуль MMC (Microsoft Management Console), и может быть использована на компьютерах, на которых установлено соответствующее программное обеспечение (для операционных систем Windows 2000/XP/Server 2003 это программное обеспечение является стандартным).

27.1  Утилита восстановления файловой базы данных

Утилита предназначена для автономной проверки и исправления файловой базы, данных без запуска конфигуратора. Важно, чтобы выбранная для проверки информационная база не была открыта в режиме Конфигуратора или 1С: Предприятия.

Запуск утилиты возможен как для проверки, так и для исправления информационной базы. Сообщения о найденных ошибках выводятся в текстовое поле, а по окончании проверок и исправлений, выводится статус завершения:

Также эта утилита может использоваться и для восстановления хранилища конфигурации.

Пакетный запуск

В командной строке запуска файла 1CV8.EXE можно указать все необходимые параметры: режим запуска, имя каталога с информационной базой, имя пользовательского каталога, и другие. Если параметры командной строки указаны верно, файл 1CV8.EXE будет запущен в одном из режимов запуска: 1С:Предприятие или Конфигуратор — в зависимости от указанных параметров.

Если при запуске файла 1CV8.EXE обнаружена ошибка в параметрах командной строки, или параметры отсутствуют, то после запуска на экран будет выдан диалог «Запуск 1С:Предприятия». В этом диалоге пользователь может выбрать режим запуска файла 1CV8.EXE, имя информационной базы и другие параметры запуска.

Используя параметры командной строки, администратор может выполнять запуск конфигуратора в пакетном режиме для выполнения следующих действий:

выгрузка/загрузка информационной базы;

сохранение/загрузка конфигурации в файл;

обновление конфигурации базы данных, в том числе находящейся на поддержке;

выполнение синтаксического контроля;

выполнение тестирования и исправления информационной базы с заданием всех параметров.

При помощи параметров командной строки администратор может указать:

запуск системы 1С:Предприятие 8.0 в режиме Конфигуратор;

параметры информационной базы: пользователь, пароль; для файлового варианта - каталог, язык; для клиент-серверного варианта - имя сервера, имя информационной базы, имя SQL-сервера, имя SQL-базы данных, имя пользователя и пароль SQL, смещение дат.

Кроме того, все параметры запуска могут быть сформированы во внешнем файле, имя которого указывается в параметрах командной строки.

После выполнения указанных в параметрах запуска действий, конфигуратор 1С:Предприятия закрывается.

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

Варианты работы

1С:Предприятие поддерживает два варианта работы: файловый и клиент-серверный. И в том, и в другом варианте все прикладные решения работают полностью идентично. Файловый вариант работы, в основном, предназначен для персонального использования, в то время как клиент-серверный вариант - для использования в рабочих группах или в масштабе предприятия.

27.2 Файловый вариант

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

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

Файловый вариант 1С:Предприятия 8.0 обеспечивает высокую целостность информационной базы и простое создание резервных копий. Исключена ситуация, когда пользователь может по ошибке (например, при копировании информационной базы) перепутать различные файлы информационной базы и привести, таким образом, систему в неработоспособное состояние.

Кроме этого резервное копирование может осуществляться на файловом уровне, путем простого копирования файла информационной базы.

27.3 Клиент - серверный вариант

Клиент-серверный вариант предназначен для использования в рабочих группах или в масштабе предприятия. Он реализован на основе трехуровневой архитектуры «клиент сервер»:

На одном из компьютеров работает сервер 1С: Предприятия 8.0. Программа, работающая у пользователя, взаимодействует с сервером 1С: Предприятия 8.0, а сервер при необходимости обращается к базе данных MS SQL Server. При этом физически сервер 1С: Предприятия 8.0 и MS SQL Server могут располагаться как на одном компьютере, так и на разных. Это позволяет администратору при необходимости распределять нагрузку между серверами. Использование сервера 1С: Предприятия 8.0 позволяет сосредоточить на нем выполнение наиболее объемных операций по обработке данных. Например, при выполнении даже весьма сложных запросов программа, работающая у пользователя, будет получать только необходимую ей выборку, а вся промежуточная обработка будет выполняться на сервере. Обычно увеличить мощность сервера гораздо проще, чем обновить весь парк клиентских машин.

Другим важным аспектом использования 3-х уровневой архитектуры является удобство администрирования и упорядочивание доступа пользователей к информационной базе. В этом варианте пользователь не должен знать о физическом расположении конфигурации или базы данных. Весь доступ осуществляется через сервер 1С: Предприятия 8.0. При обращении к той или иной информационной базе пользователь должен указать только имя сервера и имя информационной базы, а система запрашивает соответственно имя и пароль пользователя.

1С: Предприятие 8.0 использует возможности MS SQL Server для эффективной выборки информации:

механизм запросов ориентирован на максимальное использование MS SQL Server для выполнения расчетов и составления отчетов;

просмотр больших динамических списков обеспечивается без выполнения большого количества обращений к базе данных; при этом пользователю предоставляются возможности эффективного поиска, а также настройки отбора и сортировки.

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

Работа встроенного языка на сервере

При работе в клиент-серверном варианте разработчик может организовать выполнение различных процедур и функций общих модулей и модулей объектов на сервере приложения или на клиентском месте. Для этого используются свойства модулей и операторы препроцессора #Если Сервер Тогда ... #КонецЕcли и #Если Клиент Тогда ... #КонецЕсли: