Архив рубрики: Встроенные Функции

Встроенные Функции

Как открыть Конфигуратор из режима 1С:Предприятия?

Глобальный контекст
ЗапуститьСистему (RunSystem)
Синтаксис:
ЗапуститьСистему(<Дополнительные параметры комадной строки>, <Дождаться завершения>)
Параметры:
<Дополнительные параметры комадной строки> (необязательный)
Тип: Строка. Содержит дополнительные параметры, которые будет переданы новому сеансу. Если такие параметры уже есть среди текущих установок, переданные заменят текущие.
<Дождаться завершения> (необязательный)
Тип: Булево. Указывает необходимость дождаться завершения запуска системы для продолжения работы.
Значение по умолчанию: Ложь
Описание:
Запускае новый сеанс 1С:Предприятия. Новый сеанс будет запущен с текущими установками.
Примечание:
По умолчанию новая система запускается в режиме "1С:Предприятия". Если в качестве одного из дополнительных параметров будет передан ключ DESIGNER, новая система будет запущена в режиме Конфигуратора.

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

Как вывести сообщение пользователю?

Описание:
Вывести созданное сообщение в окно сообщений.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.


Синтаксис: Сообщить(<Текст сообщения>, <Статус>)
Параметры:
<Текст сообщения> (обязательный)
Тип: Строка. Текст сообщения.
<Статус> (необязательный)
Тип: СтатусСообщения. Статус сообщения. Определяет вид пиктограммы.
Значение по умолчанию: Обычное
Описание:
Выводит текст сообщения в окно сообщений. Если в момент вызова окно сообщений отсутствует, то будет открыто новое окно сообщений. Сообщение, в зависимости от его смысловой нагрузки, можно пометить одной из пиктограмм, входящих в предопределенный набор.
Не используется в модуле внешнего соединения.
Пример:


Синтаксис:
Сообщить(<Текст_сообщения>,<ИмиджМаркера>)
Назначение:
Вывести строку в окно сообщений. Перед сообщениями можно отображать специальные пиктограммы, которыми можно помечать сообщения различной важности.
Параметры:
<Текст_сообщения> — cтрока текста сообщения.
<ИмиджМаркера> — необязательный параметр. Строковое выражение, которое задает тип пиктограммы выводимой перед сообщением. Возможные значения:
I,
!,
!!,
!!!,
''.'' — обычное сообщение,
' ' (символ пробел) — без маркера.

Как Запустить, Выполнить код из внешнего файла?

В файле модуль.txt — содержится некий код и его нужно выполнить в обработке:

Что означает % (процент) в языке 1С?

Что означает % (процент) в языке программирования 1С? Например, у = х % а

Берется остаток от деления «х» на «а». Результатом всегда будет значение между 0 и а-1
Выражение удобно использовать, например, для определения момента, когда пора переходить на другой лист при выводе таблицы на печать.

Примеры:

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

Используется режим управляемых транзакционных блокировок (в автоматическом режиме для этой цели используется конструкция ДЛЯ ИЗМЕНЕНИЯ). Для того чтобы запретить чтение данных другими управляемыми транзакциями, следует устанавливать исключительный режим блокировки данных.

Как начать транзакцию в режиме управляемых транзакционных блокировок?

У метода системы НачатьТранзакцию() есть параметр, с помощью которого можно указать режим управления.

Следует помнить, что «вложенных» транзакций в системе 1С:Предприятие 8 нет. Также надо иметь в виду, что параметр «действует» только в том случае, если в свойстве конфигурации Режим управления блокировкой данных выбрано значение Автоматический и управляемый. Если для конфигурации установлен режим Автоматический, то все транзакции будут исполняться в автоматическом режиме; если Управляемый, то в управляемом режиме.

Пример:

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

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

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

Как проверить, заблокированы данные объекта или нет?

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

Следует отметить, что в случае если объект заблокирован через другую переменную (например, открытую форму объекта), то метод Заблокирован() вернет значение Ложь.

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

Если попытка заблокировать объект была удачной, это означает, что объект ранее не был заблокирован.

Как при открытии формы определить что создается НОВЫЙ элемент?


Понятие ЭтоНовый() отсутствует в 8.2.
Поэтому при необходимости определить, что создается новый элемент можно использовать следующую особенность управляемой формы.
Как правило, любая управляемая форма содержит в себе реквизит "Объект", поэтому при интерактивном создании нового элемента, Объект.ссылка не заполнено!
Исходя из этой особенности, можем прописать приОткрытии() управляемой формы следующее:

При использовании параметра Ключ:

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

МоментВремени, получение остатков до и после проведения

"Момент времени" — виртуальное поле, не хранится в базе данных. Содержит объект МоментВремени (который включает в себя дату и ССЫЛКУ НА ДОКУМЕНТ)
В 7.7 было понятие ПозицияДокумента, а в 8.x Момент времени

Для получения Остатков, Движений:
МоментВремени — это момент непосредственно перед позицией документа!
Если Вам необходимо получить момент непосредственно после позиции документа, то через объект Граница:

Пример получения остатков на дату документа, но до его движений

Пример получения остатков на дату документа, включая его движения

Чем отличается значение типа Неопределено и значение типа Null?

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

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

Как программно вызвать окошко ввода пароля Временная блокировка

Бывает что необходимо:
— При совершении определенного действия — нужно запросить пароль пользователя
— Заблокировать доступ к 1С программно

Поможет встроенная функция:
ЗаблокироватьРаботуПользователя (LockApplication)

Синтаксис:

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

Как найти существующие ссылки на объекты?

Для 8.х НайтиПоСсылкам (FindDataByRef)
Синтаксис:
НайтиПоСсылкам (< Список ссылок> )
Параметры:
<Список ссылок> Обязательный
Тип: Массив. Массив со списком ссылок на объекты, ссылки на которые нужно найти.
Возвращаемое значение:
Тип: ТаблицаЗначений. Таблица значений, состоящая из ко­лонок с индексами: 0 — Искомая ссылка; 1 — Ссылка на объект, который содержит искомую ссылку.
Описание:
Осуществляет поиск ссылок на объекты.

Функция НайтиПоСсылке имеет особенность: для корректной её работы необходимо, чтоб все объекты были доступны на чтение. Если у вас есть роли, имеющие ограничение на чтение, то вызов функции НайтиПоСсылке можно выполнять только в привилегированном модуле, иначе может возникать ошибка такого рода:
НайтиПоСсылкам(Ссылки) {(1)}: Ошибка при вызове метода контекста (НайтиПоСсылкам): У пользователя недостаточно прав на исполнение операции над базой данных.

Для 7-рки — НайтиСсылки
Находит ссылки на объекты, переданные в списке значений.
Синтаксис:
НайтиСсылки(<Объекты>,<Ссылки>)
Англоязычныйсиноним:
FindReferences
Параметры:
<Объекты> Конкретное значение объекта илиобъект типа СписокЗначений, в котором данной процедуре передаются объекты, по которым надо найти ссылки.
<Ссылки> Идентификатор объекта типа ТаблицаЗначений, в который данная процедура помещает найденные ссылки на объекты. Таблица значений состоит из 3 колонок: 1. Объект — объект, на который ссылаются; 2. Ссылка — объект, который содержит ссылку; 3. Комментарий — комментарий кссылке.
Описание:
Процедура НайтиСсылки находит ссылки на переданные в списке объекты, и помещает их в таблицу значений.

Как получить уникальный идентификатор объекта, GUID?

GUID (Globally Unique Identifier) — статистически уникальный 128-битный идентификатор. Его главная особенность — уникальность, которая позволяет создавать расширяемые сервисы и приложения без опасения конфликтов, вызванных совпадением идентификаторов. Хотя уникальность каждого отдельного GUID не гарантируется, общее количество уникальных ключей настолько велико (2128 или 3,402 * 10в38), что вероятность того, что в мире будут независимо сгенерированы два совпадающих ключа, крайне мала.

Для получения уникального идентификатора объекта, используйте код вида:

Как с помощью запроса получить уникальный идентификатор:

В 1С 7.7 можно получить так

Через v7plus.dll

Через WScript

при OLE доступе:

Еще посмотрите метод:
ЗначениеВСтрокуВнутр(<?>);
Синтаксис:
ЗначениеВСтрокуВнутр(<Объект>)
Назначение:
Преобразование значения объекта агрегатного типа в строковое системное представление.
Возвращает: представление значения объекта в строковом системном виде.
Параметры:
<Объект> — значение объекта агрегатного типа данных которое нужно преобразовать.

Получение общей системной информации, СистемнаяИнформация

Как изменить Главный, Основной Стиль, Библиотека Стилей

В Модуль приложения, в самый конец процедуры ПередНачаломРаботыСистемы() добавить:

Функции Шаблон и ФиксШаблон

Шаблон
Функции возвращают строковое значение, сформированное в соответствии с заданным параметром <Строка_шаблон>, заменив в ней все встро­енные выражения, заключенные в квадратные скобки, на их строковые значе­ния.
Строковое значение параметра <Строка_шаблон> обрабатывается сле­дующим образом: символы "[" , "]" (квадратные скобки) являются специаль­ными символами, которые выделяют поля, содержащие встроенные выражения. Выделенные поля фиксируют свою длину с учетом ограничивающих скобок. Например:
Имя Клиента [Имя], телефон: [Телефон]

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

ФиксШаблон

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

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

Как реализовать код обработки всего, а вслучае ошибки — отмены всей обработки?

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

Если необходимо по мере накопления каких-либо признаков «искусственно» отменить действия, совершаемые в транзакции, можно использовать метод системы

Использование генератора случайных чисел — Random

Генератор случайных чисел инициализируется начальным числом из параметра:

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

Еще примеры самодельных функций:


Для 7.7 можно использовать генератор случайностей

Как реализовать код в зависимости от режима выполнения (клиент, сервер, внешнее соединение)?

Если алгоритм должен выполняться по-разному в зависимости от места выполнения процедуры, то можно воспользоваться инструкциями препроцессора: