Основная страница

Глава 6

Средства встроенного языка, ориентированные на работу с распределенной ИБ

Системные функции

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

ТекущаяИБКод

Получить код текущей ИБ.

Синтаксис:

ТекущаяИБКод()

Англоязычный синоним:

CurrentIBCode()

Параметры:

Нет.

Возвращаемое значение:

Строковое выражение, состоящее из трех символов и содержащее код текущей ИБ так, как он задан в диалоге «Управление распределенными данными» Конфигуратора центральной ИБ.

Описание:

Функция ТекущаяИБКод возвращает код ИБ, на которой запущена система 1С:Предприятие.

Замечание. Функция возвращает строку, состоящую из трех пробелов, если ИБ нераспределенная.

Пример:

КодИБ = ТекущаяИБКод();

Если КодИБ = "ЦОФ" тогда

Предупреждение("Конфигурация исполняется на центральной ИБ", 3);

КонецЕсли ;

ТекущаяИБНаименование

Синтаксис:

ТекущаяИБНаименование ( )

Англоязычный синоним:

Параметры:

Нет.

Возвращаемое значение:

Строковое выражение, содержащее наименование текущей ИБ ч;

как оно задано в диалоге «Управление распределенными данным:

Конфигуратора центральной ИБ.

Описание:

Функция ТекущаяИБНаименование возвращает наименование ИБ, на которой запущена система 1С:Предприятие.

Замечание. Функция возвращает пустую строку, если ИБ нераспределенная.

Пример:

Предупреждение("Наименование текущей ИВ - " ТекущаяИВНаименование(), 2);

ЦентральнаяИБКод

Получить код центральной ИБ.

Синтаксис:

ЦентральнаяИБКод()

Англоязычный синоним:

Параметры:

Нет.

Возвращаемое значение:

Строковое выражение, состоящее из трех символов и содержащее код центральной И Б так, как он задан в диалоге «Управление распределенными данными» Конфигуратора центральной ИБ.

Описание:

Функция ЦентральнаяИБКод возвращает код центральной ИБ.

Замечание. Функция возвращает строку, состоящую из трех пробелов, если И Б нераспределенная.

Пример:

КодИБ = ТекущаяИБКод !) ;

Если КодИБ = ЦентральнаяИБКод() Тогда

     Предупреждение("Конфигурация исполняется на центральной ИБ");

КонецЕсли;

ТекущаяИБЦентральная

Определить, является ли текущая ИБ центральной.

Синтаксис:

ТекущаяИБЦентральная()

Англоязычный синоним:

1зСиггепЫВСепЬег

Параметры:

Нет.

Возвращаемое значение:

Число: 1, если текущая ИБ центральная, или 0-в противном случае.

Описание:

Функция ТекущаяИБЦентральная возвращает 1, если ИБ, на которой загущена система 1С:Предприята-: - ^--п тральная, и 0 - если периферийная.                                             _

Замечание. функЦИЯ возвращает 1. если ИБ нераспределенная.

Пример:

Если ТекущаяИБЦентральная() = 0 Тогда

Сообщ = "Конфигурация исполняется на периф" ;

Предупреждение(Сообщ, 3);

КонецЕсли;

ИБСозданияОбъекта

Определить ИБ, создавшую объект.

Синтаксис:

ИБСозданияОбъекта(<0бъект>)

Англоязычный синоним:

В1г^-ЫЗОЮЬзес1:

Параметры:

<0бъект>                Элемент справочника, документ или бухгалтерский счет.

Возвращаемое значение:

Строковое выражение, состоящее из трех символов и содержащее код ИБ, создавшей переданный в качестве параметра объект, так, как он задан в диалоге «Управление распределенными данными» Конфигуратора центральной ИБ.

Описание:

Функция ИБСозданияОбъекта возвращает код ИБ, на которой был создан первоначально объект, переданный функции в качестве параметра.

Замечание. Если создание распределенной информационной базы происходило из эксплуатировавшейся нераспределенной, то для всех элементов справочника и документов, созданных в нераспределенной ИБ, функция вернет код центральной ИБ. В нераспределенной ИБ функция вернет строку, состоящую из трех пробелов.

Пример:

//• :гротивном случае с:

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

Док = ТекущийДокумент() ;

КдСозд - ИБСозданияОбъекта(Док! ;

Если КдСозд о ТекущаяИБКод() Тогда Форма.ТолькоПросмотр(1) ;

КонецЕсли;

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

ТекущаяИБТолькоПолучатель

Определить имеет ли текущая информационная база признак «Только получатель».

Синтаксис:

ТекущаяИБТолькоПолучатель()

Англоязычный синоним:

1зСиггеп<:1ВКесер1еп1:Оп1у

Параметры:

Нет.

Возвращаемое значение:

Число: 1, если текущая ИБ центральная, или О-в противном случае.

Описание:

Функция ТекуэдаяИБТолькоПолучатель возвращает 1, если И Б, на которой запущена система 1 (^Предприятие -   имеет признак «Только получатель», и 0 - если нет.

Замечание. Функция ишщыиргт 0. ггтп ИБ нераспределенная. Пример:

Методы агрегатных объектов

Для использования возможностей выборочной регистрации изменений объектов в распределенной информационной базе у агрегатных объектов типа «Справочник» и «Документ» существует метод Регист-рацияИзменений.

РегистрацияИзменений

Включить / выключить режим регистрации изменений объ екта.

Синтаксис:

РегистрацияИзменений ([ВклВыкл])

Англоязычный синоним:

ЕпаЫеР.ед1з1:егирс1а1:е

Параметры:

[Вкл/Выкл]                Число 1 - если изменения должны регистрироваться, число 0 - если изменения не должны регистрироваться. Если параметр не указан, то режим не изменяется.

Возвращаемое значение:

Функция возвращает установленный до ее вызова режим. Число 1 - если режим регистрации для данного объекта установлен и число О,если нет.

Описание:

Метод РегистрацияИзменений доступен только у объектов типа «Справочник» и -«Документ» созданных функцией «СоздатьОбъект». Он применяется для установки режима регистрации изменений, выполняемых данным агрегатным объектом. Первоначально этот режим соответствует установленному для объектов данного вида режиму в метаданных.

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

Пример:

//Специальное перепроведение

//без регистрации изменений Процедура СпециальиоеПерепроведение()

Док = Создать0бъект(«Документ.Накладная»);

Док.Вы5ратьДокументы('01.01.98','31.12.98');

Пока Док.ПолучитьДокумент() -•1 Цикл

Док. РегистрацияИзменений (0) ;

Док.провести() ;

КонецЦикла;

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





Перейти  к оглавлению: Управление распределенными ИБ