К статье
Практический материал

Другое · 9 мин

Массив как глобальная переменная в 1С

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

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

Основной способ сделать массив глобальным — объявить его в общем модуле с свойством «Сервер» или «Сервер и толстый клиент», а также задать подходящий контекст видимости. При этом важно понимать разницу между переменной модуля, глобальной переменной и элементом общего модуля, так как от этого зависит, где именно будет храниться массив и кто сможет к нему обратиться.

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

Что понимают под глобальным массивом в 1С

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

Термин «глобальный» в 1С может относиться к разным областям видимости: переменная общего модуля, глобальная переменная конфигурации или элемент общего модуля с экспортируемой функцией доступа. Каждый вариант имеет свои правила инициализации и время жизни, поэтому перед объявлением нужно определить, кто и когда будет использовать массив.

Где объявить массив, чтобы он был глобальным

Самый частый способ — создать общий модуль, установить свойство «Сервер» или «Сервер и толстый клиент» и объявить в разделе переменных модуля массив. Затем экспортировать функции для получения и изменения этого массива, чтобы код из форм и отчетов не обращался к переменной напрямую без необходимости.

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

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

Как работать с глобальным массивом в модулях

После объявления в общем модуле массив заполняется через стандартные методы: Добавить, Вставить, Удалить и обращение по индексу. Чтобы другие модули могли менять содержимое, предоставьте экспортируемые функции, например «ПолучитьМассив» и «ЗаписатьВМассив», вместо прямого доступа к переменной модуля.

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

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

Особенности серверного и клиентского выполнения

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

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

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

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

Ограничения и риски глобальных массивов

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

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

Сравнение вариантов

Глобальный массив в общем модуле

Подходит для временных данных в рамках одного сеанса, не сохраняется после закрытия.

Таблица значений в параметрах

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

Регистр или справочник

Позволяет хранить данные между сеансами и пользователями, но сложнее в реализации.

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

Альтернативы и когда от них отказаться

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

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

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

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

Контрольные точки

Как проверить результат

Массив доступен из клиентской и серверной процедуры одного сеанса
Норма

Элементы читаются и изменяются без ошибок

Тревожный признак

Ошибка доступа или пустой массив при ожидаемых данных

Значение сохраняется между вызовами в рамках одного сеанса
Норма

Изменения видны при повторном обращении

Тревожный признак

Массив сбрасывается после каждой процедуры

Данные не видны другому пользователю в другом сеансе
Норма

Каждый сеанс имеет независимое содержимое

Тревожный признак

Изменения одного пользователя влияют на другого без явного обмена

Как проверить, что глобальный массив работает корректно

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

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

Итог

Что важно запомнить

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

Часто задаваемые вопросы

Можно ли сделать массив общим для всех пользователей базы?

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

Нужно ли объявлять массив в разделе переменных общего модуля?

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

Работает ли глобальный массив одинаково на клиенте и на сервере?

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

Что делать, если массив разрастается и замедляет работу?

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

Может ли глобальный массив потерять значения при работе пользователя?

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