1с мутабельные значения что это

от admin

1с мутабельные значения что это

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

1. Что собой представляет мутабельные значения в 1С?

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

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

К мутабельным типам в языке программирования 1С относятся:

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

Простые (примитивные) типы:

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

Предопределенным типом является цвет.

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

2. Как проверить заполненные мутабельные значения в 1С?

При переходе со старой версии платформы 1С:Предприятие (до 8.2) на актуальную нередко в момент тестирования или эксплуатации возникают ошибки проверки мутабельного значения на заполненность. Это связано с особенностью глобальной функции ЗначениеЗаполнено(). Ранее использовалась гл. функция НеЗаполнено(), которая проверяла, хоть и медленнее, но более эффективно. То есть в новых версиях платформы 1С Предприятие подобная проблема может возникнуть в тот момент, когда проверяем значение, не зная его типа.

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

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

Для проверки типа данных 1С мы можем использовать конструкцию типа:

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

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

Что есть «мутабельное значение результата»?

Здравствуйте! Возник вопрос, пожалуйста помогите кто знает!

При вызове функции 1с 8.1 выдает ошибку «Попытка передачи мутабельного значения результата метода ПолучитьВыходныеИзделия()». Серверная версия базы. Что это значит? На файловой версии базы все работает.

Каждый мутабельный знак соответствует переходной, нестабильной и податливой фазе проявления того элемента, к которому он принадлежит. Двойственные знаки, как свидетельствует само их название, могут проявляться двояко. Они с равным успехом могут и двигаться, и стоять на месте. Они амбивалентны, непредсказуемые и переменчивы. Мутабельными знаками управляют Меркурий и Юпитер — две планеты ума. А потому эти знаки (особенно Дева и Рыбы) обладают повышенной умственной и эмоциональной чувствительностью.

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

МУТАБОР )))
МУТАБОР. МУТАБОР. МУТАБОР. МУТАБОР.

И вся компания пустилась в пляс вокруг мутировавшего животного.
(Не помню, какой то старый мультик)

Передача мутабельного значения с клиента на сервер

В своей практике я сталкнулся с такой проблемой. В нашей компании была база УТ, файловый режим работы. Работала замечательно без каких либо нареканий. В один прекрачный день наш системный администратор решил файловый вариант cделать клиент-серверным. Все вроде бы работало нормально. И тут мне звоинт пользователь и говорит, что печатная форма, которой он пользовался все время, вдруг почему то перестала работать. Сообщение у пользователя выходило такое «Не удалось сформировать внешнюю печатную форму! [*]Ошибка при вызове метода контекста (ПредставлениеСерий): Попытка передачи с клиента на сервер мутабельного значения 1-го параметра метода ПредставлениеСерий ().».

Я зашел в интернет и прочитал описание мутабельного значения.

Запрос = Новый Запрос;
Запрос.УстановитьПараметр(«ТекущийДокумент», Ссылка);

Запрос.Текст =
«ВЫБРАТЬ
| Номер,
| Дата,
| Контрагент,
| Организация,
| Товары.(
| Номенклатура,
| Номенклатура.»+ ТекстКодАртикул + » КАК КодАртикул,
| Номенклатура.НаименованиеПолное КАК Товар,
| КоличествоМест,
| Количество,
| ЕдиницаИзмерения.Представление КАК ЕдиницаИзмерения,
| ЕдиницаИзмеренияМест.Представление КАК ЕдиницаИзмеренияМест,
| ХарактеристикаНоменклатуры КАК Характеристика,
| СерияНоменклатуры КАК Серия
| ),
| ВозвратнаяТара.(
| Номенклатура,
| Номенклатура.»+ ТекстКодАртикул + » КАК КодАртикул,
| Номенклатура.НаименованиеПолное КАК Товар,
| Количество,
| Номенклатура.ЕдиницаХраненияОстатков.Представление КАК ЕдиницаИзмерения
| )
|ИЗ
| Документ.ПриходныйОрдерНаТовары КАК ПриходныйОрдерНаТовары
|ГДЕ
| ПриходныйОрдерНаТовары.Ссылка = &ТекущийДокумент
|УПОРЯДОЧИТЬ ПО
| Товары.НомерСтроки,
| ВозвратнаяТара.НомерСтроки»;

Шапка = Запрос.Выполнить().Выбрать();
Шапка.Следующий();
ВыборкаСтрокТовары = Шапка.Товары.Выбрать();

Пока ВыборкаСтрокТовары.Следующий() Цикл

Если НЕ ЗначениеЗаполнено(ВыборкаСтрокТовары.Номенклатура) Тогда
Продолжить;
КонецЕсли;

ОбластьМакета.Параметры.Заполнить(ВыборкаСтрокТовары);
ОбластьМакета.Параметры.НомерСтроки = Ном;
ОбластьМакета.Параметры.Товар = ВыборкаСтрокТовары.Товар + ФормированиеПечатныхФормСервер.ПредставлениеСерий(ВыборкаСтрокТовары);

Ошибка возникала в момент когда обрабатывалась строка: «ОбластьМакета.Параметры.Товар = ВыборкаСтрокТовары.Товар + ФормированиеПечатныхФормСервер.ПредставлениеСерий(ВыборкаСтрокТовары);».
Я посмотрел еще раз описание мутабельного значения: «Передавать между клиентом и сервером (в обе стороны) можно только немутабельные значения (т.е. значения которых не могут изменяться): примитивные типы, ссылки, универсальные коллекции, значения системных перечислений, хранилище значения. При попытке передать что-либо другое – аварийное завершение клиентского приложения (даже, если передавать некорректный параметр пытается сервер). Я был удивлен универсальные коллекции можно передавать, а строку универсальной коллекции нет. Поэтому я решил воспользоваться другой универсальной коллекцией, а именно Структурой. В итоге код получился такой:

Пока ВыборкаСтрокТовары.Следующий() Цикл

Если НЕ ЗначениеЗаполнено(ВыборкаСтрокТовары.Номенклатура) Тогда
Продолжить;
КонецЕсли;

Представление = Новый Структура();
Представление.Вставить(«Характеристика», ВыборкаСтрокТовары.Характеристика);
Представление.Вставить(«Серия», ВыборкаСтрокТовары.Серия);

ОбластьМакета.Параметры.Заполнить(ВыборкаСтрокТовары);
ОбластьМакета.Параметры.НомерСтроки = Ном;
ОбластьМакета.Параметры.Товар = ВыборкаСтрокТовары.Товар + ФормированиеПечатныхФормСервер.ПредставлениеСерий(Представление);

Так что если кто то будет сталкиваться с такой же проблемой пусть знает, что строка таблицы значений является мутабельным значением и ее (строку) передавать нельзя. Нужно создать структуру.
Решение же моей проблемы было: в функции «ФормированиеПечатныхФормСервер.ПредставлениеСерий» проверялось условие:

Если ЗначениеЗаполнено(Выборка.Характеристика) и (ТипЗнч(Выборка.Характеристика) = Тип(«СправочникСсылка.ХарактеристикиНоменклатуры»)) Тогда

Если ЗначениеЗаполнено(Выборка.Серия) Тогда

Мутабельность при записи документа, через ком соединение

Платформа 8.3 управляемое приложение. При проведении через ком вот такая бяка:

Я бы для начала обрезал руки разработчику конфигурации.
Потом разработчику обработки, которая соединяется.

И да, вы угадали. По самую голову.

В подсистеме Инструменты разработчика (и в ее портативном варианте в сочетании с БСП) http://devtool1c.ucoz.ru реализован кажется наиболее универсальный вариант обхода описанной проблемы. Сама проблема у меня описана тут http://devtool1c.ucoz.ru/forum/2-218-1#866

В общем модуле ирОбщий сделано 2 функции: ЗапистьОбъектЛкс и УдалитьОбъектЛкс, имеющих параметр НаСервере. Эти функции передают почти полное, однако не все, содержимое мутабельного объекта на сервер. Во всех инструментах, выполняющих запись данных, сделан флажок «Запись на сервере» для перенаправления записи объекта на сервер.

По сути мутабельностью называют все то, что платформа не умеет сериализовать и десериализовать при вызовах клиент-сервер, однако это еще не значит что сериализовать это невозможно. В случае объектов БД кроме содержимого, имеющего штатную сериализацию, мы имеем еще свойства ОбменДанными типа ПараметрыОбменаДанными и ДополнительныеСвойства типа Структура, но самое главное у объекта имеется модуль, допускающий объявление переменных. Поэтому для полной сериализации такого объекта потребуется сериализовать рекурсивно
1. Данные. Сериализация реализована например методом ЗаписатьXML.
2. Свойство ОбменДанными. Все используемые внутри типы просто сериализуются.
3. Свойство ДополнительныеСвойства. Тут могут быть произвольные значения. Поэтому существует риски зацикливания и прочее.
4. Все переменные модуля объекта. Тут могут быть произвольные значения. Поэтому существует риски зацикливания и прочее.
Вот п.4 и есть изначальная причина обзывания объекта данных мутабельным. Потом к нему уже добавился п.3.

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

v8: мутабельное значение и толстый клиент

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

Работаю в толстом режиме, обычные формы (не управляемые).

(1) пятым параметром я передают переменную Коллекция, которая перед этой функции:

с уважением, Ваш гууууугл )))

А скриншот с содержимым КоллекцииПечатныхФорм с сервера можно?

(34) что у типовой возвращает?

у меня не возвращает, при этом даже

(37) тыкни пальцем, где я передаю мутабельное значение:

(41) вторым способом пробовал, это у обработки Реквизит с типом «ТаблицаЗначений».

в (40) инициализирую в неопределено и называю по-другому, чтобы не пересекалось с именем реквизита.

(45)>>Но мне форма не нужна, мне макет нужно

что есть в твоем понимании макет? и зачем он тебе?

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

Вот так я примерно воспринимаю автора.

Короче, что не получается?

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

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

(64) в файловой работает код, а в клиент-сервере нет.

(70) шок только от одного:

, где ВызватьКлиентскуюПроцедуру в модуле объекта описана как:

(84) разделение на клиент-сервер же нет.

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

(85) тогда еще один добавить параметр МассивТабличныхДокументов в процедуру УправлениеПечатью.СформироватьПечатныеФормы, массивТабличныхДокументов и возвращать для «особых» случаев.

тогда еще так попробую завтра. а то уже на управляемые пошел.

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

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

1с мутабельные значения что это

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

И возникает вопрос, а что такое «мутабельное значение»?

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

1С мутабельные значения что это

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

И возникает вопрос, а что такое “мутабельное значение”?

Мутабельный тип (от англ. Mutable – изменчевый) – сложный тип данных (как правило – объекты), которые после своего создания допускают изменение своих свойств.

Ошибка возникает при попытке использования функции ЗначениеЗаполнено() для проверки заполнения объекта агрегатного типа.

Читать:
Как преобразовать tiff в jpg

К таким объектам относятся программные объекты типа:

  1. СправочникОбъект, СправочникСписок, СправочникВыборка, ДокументОбъект, ДокументСписок, ДокументВыборка и т.п.;
  2. ОбработкаОбъект, ОтчетОбъект и т.п.
  3. ТабличныйДокумент, ТекстовыйДокумент, ДиаграммаГанта и т.п.;

Указанные объекты поддерживают только сравнение со значением Неопределено :

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

СПРАВКА:

Мутабельный тип (англ. Mutable type) — сложный тип данных в объектно-ориентированном программировании, значения которого (как правило — объекты) после своего создания допускают изменение своих свойств.
1С: Подробнее о типах данных 1С:Предприятие : http://v8.1c.ru/overview/CommonCommTypes.htm
1С: XML-сериализация, механизм (XML Serialization, Mechanism): http://v8.1c.ru/overview/Term_000000318.htm
tanka495: Клиент- серверные вызовы: //v8book.ru/public/86838/

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

Решаем эту проблему через помещение структуры во временное хранилище.

Конкретный пример:

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

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

Далее, в чисто серверный модуль (в конкретном случае АС_УЧЕТ_НДС) копируем исходную процедуру (модифицируем функционал при желании).

Если в ходе работы процедуры/функции на сервере передаваемое мутабельное значение должно быть изменено — помещаем его во временное хранилище по тому же адресу АдресМутабельногоЗначенияВоВременномХранилище и после выполнения функции/процедуры в исходном модуле считываем из временного хранилища.

Общий модуль

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

  • доступен только раздел описания процедур и функций (нельзя описывать переменные и программы).
  • режимы компиляции определяются опциями общего модуля
    • не требуется указывать директивы компиляции вначале процедур и функций, и хотя они не вызывают ошибок компиляции, использование директив &НаСервереБезКонтекста и &НаКлиентеНаСервереБезКонтекста сделает процедуру или функцию недоступной для любых серверных вызовов.
    • управлять компиляцией отдельных фрагментов модуля следует инструкциями препроцессора #ЕСЛИ #ИНАЧЕ #КОНЕЦЕСЛИ

    Опции Общего модуля

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

      Вызов метода общего модуля

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

      Пример косвенного вызова метода общего модуля:

      Модуль объекта

      Основное назначение модуля — обрабатывать события записи объекта где и как бы оно не возникло, в т.ч. программно, а также расширять набор методов объекта.

      • присутствует у Справочников, Документов, Отчетов, Обработок, ПВХ
        • отсутствует у Констант, Перечислений, Журналов, Внешних источников данных
        • у Регистров аналогичную роль выполняет Модуль Записи
        • переменные объявленные как Экспорт доступны у объекта как реквизиты <объект>.<Переменная>, но в отличие от реквизита она не сохраняется при записи
        • процедуры и функции описанные как Экспорт доступны у объекта как методы <объект>.<Процедура>(<параметры>)
          • по неизвестной причине доступ к переменным и методам у Обработок не действует

          Примеры

          Пример описания переменной, конструктора объекта, экспортной функции и пример вызова:

          Модуль менеджера

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

          • присутствует у Справочников, Документов, Журналов, Перечислений, Отчетов, Обработок, ПВХ, Регистров, Бизнес-процессов, Задач
            • отсутствует у Внешних источников данных
            • доступность обеспечивается только из модулей на Сервере
            • могут при необходимости получить объект или ссылку в параметре вызова

            Примеры

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

            Модуль менеджера значения

            Основное назначение модуля — обрабатывать события записи константы.

            Модуль формы

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

            • компиляция по умолчанию выполняется на Сервере, но отдельные фрагменты модуля могут устанавливать другую область компиляции директивами компиляции
            • НаКлиенте
              • реквизиты объекта формы доступны через Объект.<Реквизит>
              • реквизиты формы доступны непосредственно по имени <Реквизит>
              • элементы формы доступны через Элементы.<Элемент>
              • статические переменные существуют только на время обработки события формы, а затем удаляются
              • реквизиты объекта формы доступны через Объект.<Реквизит>
              • реквизиты формы доступны непосредственно по имени <Реквизит>
              • элементы формы на Сервере недоступны
              • статические переменные существуют только на время вызова метода на Сервере, а затем удаляются
              • данные реквизитов при каждом вызове НаКлиенте->НаСервере и возврате НаСервере->НаКлиенте все (целиком в полном объеме) проходят через XDTO сериализацию
              • доступные методы реквизитов на Клиенте и на Сервере отличаются

              Модуль набора записей

              Модуль команды

              Временный динамический модуль

              Временный динамический модуль создается платформой при использовании оператора Выполнить() :

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

                  Разделы модулей

                  • объявления переменных (кроме общих модулей)
                  • процедур и функций
                  • основной программы (кроме общих модулей)

                  Директивы компиляции и выполнения

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

                  • директива должна предшествовать каждому определению в модуле
                  • по умолчанию действует директива &НаСервере
                  • директива &НаСервереБезКонтекста имеет смысл только в формах (чей контекст директива подразумевает)
                  • определение в общем модуле с директивой &НаСервере в общем модуле имеет
                  • директива &НаСервереНаКлиенте применяется только в коде модулей команд
                  • приведенный в таблице порядок директив соответствует иерархии доступности, так функции и процедуры определенные с некоторой директивой имеют доступ к процедурам и функциям определенным с той же директивой, либо с любой директивой следующей ниже, но не имеют доступа к определенным с предшествующей директивой
                    • определениям с директивой &НаКлиенте доступны все определения на Клиенте и все определения на Сервере, для которых предусмотрен серверный вызов
                    • определениям с директивой &НаКлиентеНаСервереБезКонтекста доступны определения только с такой же директивой

                    Инструкции препроцессора

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

                    Предусмотрены четыре инструкции

                    • #Если <Логическое выражение> Тогда
                    • #ИначеЕсли <Логическое выражение> Тогда
                    • #Иначе
                    • #КонецЕсли
                    • <Логическое выражение> = [НЕ] <Символ препроцессора> [<Булева операция> [НЕ] <Символ препроцессора> [<Булева операция> [НЕ] <Символ препроцессора>]…]
                    • <Символ препроцессора> = <НаКлиенте | НаСервере | ТолстыйКлиентОбычноеПриложение | ТолстыйКлиентУправляемоеПриложение | Клиент | Сервер | ВнешнееСоединение >
                      <Булева операция> =

                    Области

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

                    Области выделяются с помощью двух инструкций препроцессора #Область и #КонецОбласти :

                    • <имя области> должно соответствовать общим требованиям к именам переменных (не может начинаться с цифры, содержать пробелы, знаки и символы и т.п.).
                    • области могут быть вложены друг в друга или в другие группируемые конструкции языка.
                    • это возможно, но 1С не рекомендует разрывать областями отдельные грамматические конструкции, выражения, а также объявления и места вызова процедур и функций:
                    Области типовых конфигураций 1С:
                    • Модуль объекта
                      • ПрограммныйИнтерфейс
                      • ОбработчикиСобытий
                      • СлужебныеПроцедурыИФункции
                        • ИнициализацияИЗаполнение
                        • Прочее
                        • ПрограммныйИнтерфейс
                        • ОбработчикиСобытий
                        • СлужебныеПроцедурыИФункции
                          • СлужебныйПрограммныйИнтерфейс
                            • Обеспечение
                            • НаправленияДеятельности
                            • Проведение
                            • Отчеты
                            • Печать
                            • ШаблоныСообщений
                            • Прочее
                            • ТекущиеДела
                            • ОбновлениеИнформационнойБазы
                            • ФормированиеГиперссылкиВЖурналеДокументыПродажи
                            • Назначения
                            • ОписаниеПеременных
                            • ОбработчикиСобытийФормы
                            • ОбработчикиСобытийЭлементовШапкиФормы
                            • ОбработчикиСобытий
                            • ОбработчикиСобытийЭлементовТаблицыФормыТовары
                            • ОбработчикиКомандФормы
                            • СлужебныеПроцедурыИФункции

                            Предопределенные Объекты конфигурации

                            В модулях используются объекты данных с предопределенными именами

                            ЭтаФорма
                            • Используется в модуле формы в процедурах &НаКлиенте и &НаСервере для обращения к элементам формы и реквизитам
                            • Пример обращения к элементу формы через объект Элементы: ЭтаФорма.Элементы.НомерВерсии.Заголовок = ‘My God!’;
                            • Пример обращения к реквизиту формы: ЭтаФорма.ТекстОбъявления=’Hello!’;
                            • В модуле формы ключевое слово ЭтаФорма необязательно и допускается: Элементы.НомерВерсии.Заголовок = ‘My God!’;
                            • Описанные выше способы применимы только к простым типам
                            • Для сложных типов (ТаблицаЗначений, ДеревоЗначений) обращение приводит к объекту типа ДанныеФормыКоллекция
                            • Для получения значения объекта формы сложного типа применяется метод: <переменная>=РеквизитФормыВЗначение(<ИмяРеквизита>);
                            • Для установки значения объекта формы сложного типа применяется: ЗначениеВРеквизитФормы(<Значение>, <ИмяРеквизита>);
                            • Функции РеквизитФормыВЗначение() и ЗначениеВРеквизитФормы() доступны только на Сервере.
                            Объект
                            • Является именем основного реквизита управляемой формы, который хранит данные ИБ открытые в управляемой форме, например: Объект.Ссылка;
                            • Имя реквизита Объект может быть изменено, но делать это не принято.
                            • Полный формат: ЭтаФорма.Объект.Ссылка;
                            ЭтотОбъект
                            • Указывает на объект формы для доступа к реквизитам формы
                            • Допускает только чтение
                            • Доступен для Сервер, Толстый клиент, Внешнее соединение
                            Запись

                            В модуле записи регистра.

                            Элементы

                            Коллекция Элементы В модуле формы НаКлиенте содержит все элементы формы

                            • Элементы.<имя элемента>
                            • Элементы(«<имя элемента>»)
                            • ?Получить значение элемента ни свойством, ни методом нельзя

                            Аннотации расширения модулей

                            Три аннотации позволяют определить перехват порядка вызова типовых методов новыми методами.

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

                              Источник: Расширение модулей //wonderland.v8.1c.ru

                              Объекты модулей

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

                              Передача параметров и возвращаемых значений

                              Для характеристики типов значений в 1С используется понятие мутабельность (от англ. Mutable — изменчивый), которое нуждается в разъяснении. Немутабельными типами являются простые типы (Число, Строка, Дата, Булево, Цвет, Ссылка), для которых определены пустые значения. Мутабельными типами являются сложные типы (Структура, Массив, СписокЗначений, ТаблицаЗначений, ДеревоЗначений, Объект, Форма и т.п.), свойства которых могут быть изменены после создания, а проверка на пустое значение лишена смысла.

Похожие статьи