Встроенный язык

Сервисные функции

Синтакс - помощник

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

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

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

Справочная информация отображает собственно страницу с информацией по выбранной теме/режиму приложения. Информация может быть представлена на английском и русском языках. Возможен поиск по подстроке и перетаскивание готовых синтаксических конструкций в модуль. Комбинация клавиш для вызова Синтакс-Помощника - Ctrl+Shift+F1.

Подсказку по конкретному элементу языка (оператору, процедуре, функции, свойству, методу) можно получить, если поместить курсор в модуле на этот элемент языка и нажать клавиши Ctrl+F1. В Синтакс - Помощнике будет выдано описание выбранного элемента встроенного языка.

Синтаксический контроль

Редактируемый модуль может быть проверен на правильность использования синтаксических конструкций встроенного языка. Для выполнения синтаксического контроля модуля необходимо воспользоваться пунктом "Текст - Синтаксический контроль".

Синтаксический контроль выполняется в следующей последовательности:

• Общие модули;
• Модуль приложения;
• Модуль объекта;
• Модуль формы.

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

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

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

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

Использование шаблонов текста

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

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

Для управления списком шаблонов разработчик может использовать специальное окно, вызываемое из меню "Сервис - Шаблоны текста".

Все шаблоны хранятся в файлах с расширением *.st, и разработчик может создать новый файл шаблонов или подключить существующие через меню "Действия - Файлы шаблонов" из окна "Шаблоны текста".

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

Разработчик имеет возможность создавать новые и редактировать существующие шаблоны. Редактирование шаблонов выполняется в специальном окне, которое вызывается через меню "Действия - Изменить" окна "Шаблоны текста" и содержит список шаблонов и текст выбранного шаблона. Динамическая часть шаблона выделяется специальными символами < >.

При редактировании текстового документа или модуля, возможна быстрая вставка шаблона после того, как будет набрана последовательность символов, указанная в шаблоне. Вставка производится при нажатии клавиши Пробел или Enter.

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

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

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

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

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

Произвольный запрос. Используется для ввода произвольного текста. В тексте шаблона появится управляющая конструкция вида

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

Пример получения остатка конкретного материала из регистра накопления "ОстаткиМатериалов":

ТекМатериалОтбор = Новый Структура("Материал",ВыбМатериал); 

ТабЗначенийМатериалОстатки = РегистрыНакопления.ОстаткиМатериалов.Остатки(Дата, 
 ТекМатериалОтбор, "Материал ","Количество,Сумма"); 

Сообщить(ТабЗначенийМатериалОстатки[0].Количество);

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

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

Через набор записей также можно обращаться к уже существующим записям регистра накопления. Для этого нужно установить свойство Отбор и прочитать записи из базы данных. Свойство Отбор является объектом типа Отбор, свойства которого совпадают с именами измерений регистра и являются объектами типа ЭлементОтбора.

Например:

Набор = РегистрыНакопления.Услуги.СоздатьНаборЗаписей(); 
Набор.Отбор.Регистратор.Значение = ВыбДок; 
Набор.Прочитать(); 
Для Каждого Движ из Набор цикл 
    Сообщить(Движ.Сумма); 
КонецЦикла;

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

Проведение - разрешает или запрещает проведение документа при записи

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

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

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