Admin: 1 revision imported

2021-02-07T06:43:11Z

1 revision imported

Admin at 16:22, 9 June 2019

2019-06-09T16:22:47Z

New page

{{infobox function
|name=BroadcastDBUpdate
|object=[[Функции общего назначения]]
|caption=Серверные функции
|type=1
|status=2
|db=1
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция рассылает запросы на обновление форм, содержащих таблицы базы данных указанного типа в текущей системе или глобально по всем клиентам сервера. В последнем случае, нужно быть осторожным, чтобы не перегружать сервер внезапным большим количеством запросов, даже с учетом того, что серверная часть использует особую систему замедления отправки запросов клиентам. Функция может использоваться для журналов или справочников, за которыми следят большое количество операторов. Функция позволяет использовать обновление только в нужное время, чтобы не перегружать сервер базы данных, использование такой возможности вместо настройки автоматического обновления в редакторе форм зачастую предпочтительнее, но усложняет текст программы.

== Синтаксис ==
<code>
'''BroadcastDBUpdate'''(''<Тип базы данных (STRING)>''{{Optional|,<Для всех пользователей (INT)>{{Default|{{Eq}}0}}}}):''<Сообщение успешно отправлено (INT)>''
</code>
==== Аргументы ====
* <code>''<Тип базы данных (STRING)>''</code> - Тип базы данных, таблицы с которым должны быть обновлены, в виде <code><Тип базы данных>.<Вид базы данных></code> (к примеру ''REF.Номенклатура'').
* <code>''<Для всех пользователей (INT)>''</code> - {{Optional}} Режим отправки сообщения, может принимать значения:
** '''0''' (по умолчанию) -- отправка сообщения об обновлении только внутри текущего клиента. Все таблицы, которые содержат указанных тип будут обновлены (обычно система сама выполняет такое действие при визуальном сохранении объекта, однако, если объект изменен программно, возможно, потребуется воспользоваться этой функцией).
** '''1''' -- отправка сообщения об обновлении всем пользователям сервера. Сообщения такого рода отправляются каждому клиенту по очереди с небольшим периодом ожидания, чтобы исключить внезапную загрузку сервера.

==== Возвращаемое значение ====
Возвращает 1, если сообщение отправлено успешно, 0, в ином случае.

== Примеры ==
<pre>
//Отправить обновление журнала всем пользователям после сохранения документа, входящего в журнал
BroadcastDBUpdate("Jor.Отгрузка",1);
</pre>

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)

BroadcastDBUpdate - Revision history

Admin: 1 revision imported

Admin at 16:22, 9 June 2019