Меасофт - Вклад участника [ru]

Модуль «Карта»

2026-03-25T06:57:10Z

Sammy: /* Группировка адресов */

== Назначение ==

Модуль предназначен для визуального планирования городских доставок и создания [[Зоны на карте|тарифных зон]] на карте в режиме [[#Единое районирование|единого районирования]].

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

На вкладке '''Заказы''' выделите заказы и нажмите на клавишу ПРОБЕЛ или выберите пункт контекстного меню '''Перейти к адресам'''. На вкладке '''Адреса''' отобразятся отправления, которые нужно доставить или забрать. Для удобства список корреспонденции можно [[Основные принципы работы в программе#Сортировка списка адресов|отсортировать]].

Чтобы открыть заказы на карте, на вкладке '''Адреса''' нажмите на кнопку [[Файл:Показать на карте.jpg|30 px]]. Чтобы посмотреть определенное отправление, выделите его и выберите пункт контекстного меню '''Показать на карте'''.

Откроется окно «Карта»:

[[Файл:Карта.png|none]]

Верхнее меню содержит следующие кнопки:

[[Файл:Globe.png]] — обзор всей карты;

[[Файл:Print.png]] — печать видимого участка карты;

[[Файл:Settings.png]] — [[Модуль «Карта»#Настройки|настройки отображения]] информации на карте;

[[Файл:Кнопка_Поиск.png]] — поиск по адресу или координатам.

В панели слева настройте отображение списка курьеров:
* выберите из выпадающего списка филиал, курьеров которого нужно просмотреть;
* укажите менеджеров, чьих курьеров нужно отобразить в списке;
* укажите дату планируемой доставки для курьеров. Чтобы курьер отображался в списке, должны быть выполнены следующие условия:
*# В карточке курьера указана дата приема на работу;
*# Для курьера установлено свободное посещение или есть график на дату планирования. Подробнее см. раздел «[[Графики работы сотрудников]]».

В окне справа отображается карта с адресами отправлений, отмеченными [[Модуль «Карта»#Настройка карты|маркерами]].

===Ненайденные адреса ===

Адреса, которые не удалось найти на карте, отображаются в нижней части окна.

Если адрес не отображается на карте:
* щелкните дважды по строке ненайденного адреса и в карточке корреспонденции проверьте правильность написания соответствие [[Знакомство с программой#Ввод адресной информации|правилам ввода адресной информации]];
* в контекстном меню списка ненайденных адресов выберите '''Поискать адрес на карте'''. Если адрес найден, перетащите запись из нижней части окна на точку, найденную на карте;
* в контекстном меню списка ненайденных адресов выберите '''Поискать адрес в интернете'''. Откроется окно браузера по умолчанию с адресом на карте. Скопируйте координаты найденного адреса, вставьте в строку поиска сверху и нажмите на кнопку [[Файл:Кнопка_Поиск.png]]. На карте отобразится найденный адрес в виде зеленого ромба. Перетащите запись из нижней части окна на точку, найденную на карте. Изображение ромба пропадет, если удалить из строки поиска координаты его широты и долготы;
* если вы точно знаете местоположение ненайденного адреса на карте, перетащите адрес в нужное место.

Если маркер корреспонденции отмечен не на том месте, открепите точку через контекстное меню (адрес перенесется в «ненайденные»), а затем перетащите на нужное место.

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

=== Настройки===

Настройки вызываются по нажатию на [[Файл:Settings.png]]. Окно настроек выглядит следующим образом:

[[Файл:Карта_маркеры.png|none|300px]]

====Настройка карты====

Вкладка предназначена для установки отображения корреспонденции на карте. Вы можете выбрать один из вариантов:
* '''Цвета состояния''' — корреспонденция отмечается в зависимости от ее статуса. Можно изменить цвета, выбранные по умолчанию. Чтобы изменить цвет, нажмите на кнопку [[Файл:More.png]] справа от цвета, откроется окно с вариантами. Выберите нужный и нажмите '''ОК'''. Этот режим помогает логисту видеть запланированные и незапланированные на курьеров доставки;
*''' Цвета курьеров''' — корреспонденция отображается цветом назначенного курьеру маркера. Предусмотрено 24 разных цвета для курьеров. Если все цвета уже назначены, всем последующим курьерам присваивается белый цвет. Этот режим помогает видеть район доставки корреспонденции на карте при относительно небольшом количестве курьеров.

===== Группировка адресов =====

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

Цветовая схема маркеров помогает быстрее оценить состояние планирования:

* '''Чёрный круг''' — не все адреса в точке запланированы на курьеров.
Пример: текст ''5/10'' означает, что из 10 адресов запланировано только 5.

* '''Зелёный круг''' — все адреса в точке распределены между курьерами.

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

* '''Жёлтый круг''' — в точке есть адреса, закреплённые за выбранным курьером.
Пример: текст ''1/10'' — на выбранного курьера назначен 1 адрес из 10.

* '''Красный круг''' — у выбранного курьера есть адреса в этой точке, и часть остальных адресов пока не запланирована.
Такие адреса можно «докинуть» курьеру, так как он всё равно посещает эту точку.
Пример: текст ''3/10'' — на выбранного курьера запланировано 3 адреса из 10.

* '''Двухцветный круг''' , одна половина '''черная''', другая '''красная''' - в точке адреса запланированы, но на разных курьеров.
Пример: текст ''7/8'' — на курьеров запланировано 7 адресов из 8, причем 7 адресов запланированы на разных курьеров.

==== Печать ====

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

Чтобы улучшить качество изображения, введите коэффициент усиления контрастности печати.

Варианты печати карты:
* печать карты из окна «Карта». Слева вверху нажмите на кнопку '''Печать''';
* автоматическая печать. Позволяет распечатывать карту вместе с документами, необходимыми при выдаче корреспонденции. Можно <rspoiler text="настроить печать">'''Справочники''' > '''Переменные''' > '''Печать''' > '''Печатать карту при выдаче'''. Возможные значения: '''Не печатать''', '''Печатать после акта''' (если нужно нумеровать корреспонденцию на печатной карте) и '''Печатать до акта''' (если нужно нумеровать адреса на печатной карте).</rspoiler>до выдачи или после выдачи акта.

Существуют следующие варианты обозначения корреспонденции на печатной карте при выдаче:
* нумеруется корреспонденция. Внутри каждого квадрата находится порядковый номер корреспонденции из акта приема-передачи курьеру. Если получателю предназначены несколько отправлений, на карте в квадрате будут перечислены их порядковые номера из акта приема-передачи. Такой вид отображения удобен, когда курьеру нужно сообщить логисту о передаче корреспонденции получателю. Курьер сообщает номер корреспонденции, логист отмечает передачу в программе. <spoiler text="Настройка переменной">
'''Справочники''' > '''Настройка''' > '''Печать''' > '''Акты передачи курьеру''' > '''Сохранять номер строки в акте передачи курьеру''' > '''Запоминать из актов'''</spoiler>
* нумеруются адреса корреспонденции. Внутри каждого квадрата находится порядковый номер адреса. Если получателей несколько на один адрес, на вкладке '''Выдача''' в графе '''Номер в акте''' у нескольких корреспонденций будет один порядковый номер.<spoiler text="Настройка переменной">'''Справочники''' > '''Настройка''' > '''Печать''' > '''Акты передачи курьеру''' > '''Сохранять номер строки в акте передачи курьеру''' > '''Запоминать из карт'''</spoiler>Пример карты:
[[Файл:Печать на карте.jpg|500px|none]]

==== Хинты ====

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

Всплывающие подсказки настраиваются отдельно для отображения карты в разных режимах:
* по кнопке '''Адреса ''' — подсказки на вкладке '''Адреса''';
* по кнопке '''Трекинг''' — подсказки при просмотре маршрута курьера в [[Функции#Трекинг курьеров|трекинге]];
* по кнопке '''Выдача в трекинге''' — подсказки при просмотре выданной корреспонденции в [[Функции#Трекинг курьеров|трекинге]].

=== Дополнительные возможности ===

В программе предусмотрены параметры, которые позволяют задать условия отображения маркера на карте. Например, можно сделать заборы большими синими треугольниками, а вечерние доставки отображать маленькими желтыми квадратиками. Подробнее см. раздел [[Системные доп. возможности#Настройка вида маркера | «Руководство программиста»]].

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

=Виды планирования=
* Планирование по курьерам с помощью карт:
** [[Модуль «Карта»#Ручное планирование|вручную]]
** [[Модуль «Карта»#Планирование схемами|схемы]]
** позаказно
* Планирование по списку
* Планирование маршрутов курьеров:
**[[#Ручное планирование маршрутов|ручное планирование маршрутов]]
** автоматическое планирование [[Максоптра]]
** автоматическое планирование [[Яндекс.Маршрутизация]]

=== Ручное планирование по курьерам ===
Виды ручного планирования:
* назначение курьера на маркер. В контекстном меню маркера корреспонденции выберите '''Запланировать'''. Заказ планируется на сотрудника, выбранного в списке слева. По умолчанию это первый в списке курьер. Чтобы выбрать конкретного курьера, в контекстном меню маркера выберите '''Запланировать для курьера''';
* перемещение маркеров. Например, курьер на доставку запланирован, нужно добавить ему еще отправления. Удерживая нажатой кнопку CTRL, перетащите свободный маркер на маркер c запланированным сотрудником. В результате два адреса планируются для доставки одним сотрудником. Если на обоих маркерах уже запланированы курьеры, при перемещении одного на другой отправление будет назначено сотруднику, на маркер которого перетащили;
* выделение области. Удерживая нажатой правую кнопку мыши, обведите область с маркерами, затем в контекстном меню области выберите пункт '''Запланировать для курьера'''. В результате отправления этой области назначена на доставку указанному сотруднику.

=== Планирование схемами по курьерам ===
;Схемы
: Графически выделенные контуры районов доставки, сохраненные на карте, возможно, с назначенными на них курьерами.

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

[[Файл:зонирование.png|none]]

==== Создание схемы ====
# Выберите заказы, перейдите на вкладку '''Адреса''' и нажмите на кнопку [[Файл:Показать на карте.jpg|30 px]]. Откроется окно «Карта».
# Нажмите на кнопку '''Добавить'''.
# В выпадающем списке выберите добавленную схему.
# Нажмите на кнопку [[Файл:Кнопка Опции.png]] рядом с кнопкой '''Добавить''' и выберите пункт '''Редактировать схему'''.
# В контекстном меню на карте выберите пункт '''Создать контур'''. Подробнее см. раздел «[[Зоны на карте#Создание контуров на карте|Создание контуров на карте]]».
# При помощи правой клавиши мыши выставляйте точки контура так, чтобы получилась замкнутая область. Когда контур готов, нажмите ENTER. Чтобы объединить соседние контуры, выделите их, удерживая зажатой клавишу CTRL, и в контекстном меню выберите '''Объединить контуры'''.
# Чтобы назначить курьера на контур, в контекстном меню выберите пункт '''Установить курьера'''.
# Создайте столько контуров с назначенными курьерами, сколько нужно для работы, и нажмите на кнопку '''Завершить'''.
# Нажмите на кнопку [[Файл:Кнопка Опции.png]] рядом с кнопкой '''Добавить''' и выберите пункт '''Параметры схемы'''. В открывшемся окне укажите название схемы и выберите филиал, к которому будет относиться схема.

Пункт контекстного меню '''Указать номер зоны''' используется в клиентской автоматизации, не входящей в стандартную поставку. <spoiler text="Подробнее">Автоматизация создает начисления, компенсирующие курьерам затраты на ГСМ. Зонам на схеме присваивается номер, соответствующий размеру компенсации ГСМ. Например, номер зоны 200 означает, что компенсация равна 200 рублям. Автоматизация учитывает вчерашние выдачи со статусами «Отказ на месте» и «Доставлено», начисляет компенсацию каждому курьеру по самой удаленной зоне доставки и выводит сумму к выдаче в АПК.</spoiler>
При создании контуров не допускайте пустоты и пересечения контуров. Если адрес доставки или забора попадет в пустое место между контурами, то в режиме [[Модуль Карта#Полуавтоматическое планирование|полуавтоматического планирования]] ни один курьер не будет назначен на доставку. Если адрес попадет на пересечение контуров, то курьер будет выбран случайно из назначенных на пересекающиеся области.

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

==== Планирование ====
Чтобы начать планирование, в окне «Карта» выберите [[#Создание схемы|созданную схему]] из выпадающего списка и нажмите на кнопку '''Проставить по всем'''. Корреспонденция распределится между работающими курьерами, по завершении операции формируется отчёт в отдельном окне. Можно использовать способы [[#Ручное планирование|ручного планирования]].

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

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

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

==== Удаление схемы ====
В окне «Карта» выберите схему из выпадающего списка, нажмите на кнопку [[Файл:Кнопка Опции.png]] рядом с кнопкой '''Добавить''' и выберите пункт '''Удалить схему'''.

===Ручное планирование маршрутов===

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

# В окне «Карта» нажмите на кнопку '''Доставка'''. Если есть корреспонденции, запланированные на курьера на указанную дату, маршруты автоматически сформируются и отобразятся на карте. Точки в маршрутах располагаются в случайном порядке.
# [[#Запланировано|Скорректируйте]] маршруты при необходимости и нажмите на кнопку '''Подтвердить все маршруты'''. Номера точек в маршруте заносятся в [[путевые листы]].

[[Файл:Ручная маршрутизация.png|none|1500 px]]

Информация в панели '''Доставка''' сгруппирована по вкладкам:
* Запланировано — общая информация о сформированных маршрутах. Поля «Отбытие», «Прибытие», «КМ» не заполняются;
* Не запланировано — список отправлений, которые не запланированы на курьера или на дату или не найдены на карте.

Вы можете использовать способы [[#Ручное планирование|ручного планирования]] на карте для указания курьера.

====Запланировано====
В таблице «Маршруты» содержится общая информация о сформированных маршрутах.

Возможные действия:
* добавить новый маршрут для курьера, еще не указанного в списке — в контекстном меню выберите '''Создать новый маршрут''' и укажите сотрудника;
* запланировать сформированный маршрут для выбранного курьера — в контекстном меню выберите '''Запланировать''';
* назначить другого курьера для сформированного маршрута — в контекстном меню выберите '''Запланировать для курьера'''.

В таблице «Адреса» перечислены точки, входящие в маршрут курьера, выделенного в таблице «Маршруты» выше. Точки в маршрутах располагаются в случайном порядке. Вы можете перемещать точки:
* внутри маршрута — комбинацией клавиш ВВЕРХ + CTRL и ВНИЗ + CTRL или с помощью пунктов контекстного меню '''Передвинуть выше''' и '''Передвинуть ниже''';
* между маршрутами — используйте пункт контекстного меню '''Переместить в маршрут'''. Точка добавляется в конец списка адресов.

Выделенная в списке точка подсвечивается в маршруте на карте.

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

Чтобы подтвердить сформированные маршруты, нажмите на кнопку '''Подтвердить все маршруты'''. Номера точек в маршруте заносятся в [[путевые листы]].

====Не запланировано====

Вкладка содержит список отправлений с ошибками планирования. Строки выделены розовым цветом, при наведении курсора мыши на строку или в столбце «Примечание» отображается подсказка с причиной ошибки:
* не запланирован на курьера — используйте пункт контекстного меню '''Переместить в маршрут'''. Точка добавляется в конец списка адресов маршрута;
* не подходит план. дата доставки — откройте корреспонденцию щелчком по строке и исправьте дату доставки;
* местоположение не подтверждено — выполните действия, описанные в разделе [[#Ненайденные адреса|«Ненайденные адреса»]];
* курьер не доступен по графику — убедитесь, что в карточке курьера есть [[Графики работы сотрудников|график]] на дату планирования.

=== Автоматическое планирование ===
Вид планирования, который позволяет автоматизировать назначение курьеров и просчет оптимальных маршрутов доставки корреспонденции с учетом дорожных условий.

В MeaSoft доступны интеграции с сервисами автоматического планирования:
* [[Maxoptra]]
* [[Яндекс.Маршрутизация]]

= Картографическая система =

Программа MeaSoft работает с картографической системой [http://www.openstreetmap.org '''OpenStreetMap'''].

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

Карты OpenStreetMap позволяют создавать области и тарифицировать зоны, назначать курьеров в окне '''Карта''', планировать курьеров на доставку.

OpenStreetMap не умеет строить маршруты курьеров, для работы с новыми областями необходимо постоянное подключение к интернету. Просмотренные области карты [[Терминология#Карта|кешируются]] и в дальнейшем доступны для работы даже без интернета.

Система OpenstreetMap в программе MeaSoft не требует никакой региональной настройки и сразу готова к работе.

= Геокодирование =

== Описание и принцип работы ==
Для отображения любой информации на карте используется [https://ru.wikipedia.org/wiki/Геокодирование геокодирование].

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

При записи и чтении из кэша срабатывает упрощение адреса: до первой запятой — считается улицей, 5 символов после — номер дома. Использование упрощения адресов определяется переменной '''Справочники''' > '''Переменные''' > '''Подключения''' > '''Карты''' > '''Геокодирование''' > '''Отключить упрощение адреса при геокодировании''':
* если упрощение включено, в кеш записывается не весь найденный адрес, а только часть. Перед поиском адрес также сначала упрощается. Например, адрес вида «Солнечногорск, улица Островского, 1» и «Солнечногорск, улица Гоголя, 1» упрощается до «Солнечногорск, улица». И программа оба адреса сведет к одной точке. При включении упрощения точность до дома не гарантируется;
* если упрощение адреса выключено, поиск и запись адреса в кеш ведется в том виде, в каком он указан, и время определения координат может увеличиться. При разнице хотя бы в один символ нужен повторный запрос к геокодеру. Например, эти адреса будут разными: «Солнечногорск, улица Островского, 1» и «Солнечногорск, улица Островского, д1».

Для улучшения результатов геокодирования при включенном упрощении указывайте адрес по стандарту MeaSoft. Например, в поле '''Адрес''' нужно указать «улица Островского, 1», а в поле '''Город''' указать «Солнечногорск». Тогда точность будет высокой при хорошей скорости геокодирования.

Если геокодер MeaSoft не нашел адрес, он может сделать запрос к платному геокодеру: [https://www.ahunter.ru/ Ахантер] и к [https://yandex.ru/maps Яндекс. Картам]. Сервер геокодирования Яндекс. Карт, получая запрос, преобразует адреса в координаты и ищет соответствия по своей базе данных, затем возвращает адреса в программу. В окне «Карта» отображаются маркеры адресов, которым сервер Яндекс. Карт смог найти соответствия.

== Настройка ==
Данные сервера геокодирования Яндекс.Карт находятся в '''Справочники''' > '''Переменные''' > '''Подключения''' > '''Карты''' > '''Яндекс''' > '''Сервер геокодирования Яндекс'''.

Чтобы адреса корректно определялись на карте, перейдите по [https://developer.tech.yandex.ru/ ссылке] и получите ключ «JavaScript API и HTTP Геокодер», затем укажите его в '''Справочники''' > '''Переменные''' > '''Подключения''' > '''Карты''' > '''Геокодирование''' > '''API-Ключ'''.

== Лимиты геокодирования Яндекс.Карт ==
Из-за существенного уменьшения лимитов запросов Яндексом - в данный момент в сутки на общий АПИ ключ дается только 1000 запросов на всех пользователей сервиса.
Для увеличения лимитов вы можете добавить свой АПИ ключ Яндекса.

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

=Единое районирование=

;Единое районирование
:Cистема планирования работы курьеров, при которой заказы распределяются по районам, нарисованным на карте. Этот метод пришел на смену планированию по станциям метро. Единое районирование работает для всех филиалов компании.

Чтобы включить единое районирование:
# Выберите '''Справочники''' > '''Переменные''' > '''Финансы''' > '''Расчет района по адресу''', установите значение переменной '''1''' и нажмите '''Сохранить'''. При этом автоматически включатся связанные переменные '''Расчет стоимости по адресу''' и '''Расчет зоны курьера по адресу'''.
#: Можно включить единое районирование для отдельных пользователей. Для этого после 0 укажите через запятую <rspoiler text=имена>'''Настройки''' > '''Пользователи''' > карточка пользователя > поле '''Имя пользователя''' </rspoiler> конкретных пользователей и нажмите '''Сохранить''':[[Файл:Edinoe raionirovanie.png|none|700px]]
# Выберите '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Планировать по курьерам в режиме многофилиальности'''. Возможные значения переменной:
#* '''0''' — адреса на карте планируются по районам, в окне слева будет отображаться список районов;
#* '''1''' — адреса на карте планируются по курьерам, в окне слева будет отображаться список курьеров.
#: Чтобы внедрять функциональность в работу постепенно, в переменных можно указать отдельных пользователей аналогично действиям в пункте 1.
#: Установите значение переменной и нажмите '''Сохранить'''.
# Выберите '''Справочники''' > '''Переменные''' > '''Умолчания''' > '''Псевдоним метро''' и введите название, которое заменит слово «метро» в интерфейсе программы. Например, «районы».
# После изменения значения переменных перезагрузите программу MeaSoft.
После включения единого районирования станут недоступны справочники '''Метро''', '''Улицы''', планирование по станциям метро. Чтобы установить тарифные зоны:
# Выберите '''Справочники''' > '''Районы''', нарисуйте районы доставки на карте и закрепите за ними курьеров для автоматического планирования.
# Выберите '''Справочники''' > '''Зоны на карте''' и нарисуйте зоны курьеров и/или клиентов. Подробнее см. раздел [[Зоны на карте|«Зоны на карте»]].

По завершении всех настроек на вкладке '''Адреса''' выделите несколько адресов и нажмите на кнопку [[Файл:Показать на карте.jpg|30 px]]. В зависимости от значения переменной '''Планировать по курьерам в режиме многофилиальности''' на карте в окне слева отобразится список курьеров или районов доставки. Если отображается неполный список курьеров, перейдите в карточку отсутствующего в списке сотрудника и проверьте, указаны ли у него дата приема на работу и график работы.

<spoiler text="См. также">
[[Графики работы сотрудников]]</spoiler>

Модуль «Карта»

2026-03-25T06:55:14Z

Sammy: /* Группировка адресов */

== Назначение ==

Модуль предназначен для визуального планирования городских доставок и создания [[Зоны на карте|тарифных зон]] на карте в режиме [[#Единое районирование|единого районирования]].

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

На вкладке '''Заказы''' выделите заказы и нажмите на клавишу ПРОБЕЛ или выберите пункт контекстного меню '''Перейти к адресам'''. На вкладке '''Адреса''' отобразятся отправления, которые нужно доставить или забрать. Для удобства список корреспонденции можно [[Основные принципы работы в программе#Сортировка списка адресов|отсортировать]].

Чтобы открыть заказы на карте, на вкладке '''Адреса''' нажмите на кнопку [[Файл:Показать на карте.jpg|30 px]]. Чтобы посмотреть определенное отправление, выделите его и выберите пункт контекстного меню '''Показать на карте'''.

Откроется окно «Карта»:

[[Файл:Карта.png|none]]

Верхнее меню содержит следующие кнопки:

[[Файл:Globe.png]] — обзор всей карты;

[[Файл:Print.png]] — печать видимого участка карты;

[[Файл:Settings.png]] — [[Модуль «Карта»#Настройки|настройки отображения]] информации на карте;

[[Файл:Кнопка_Поиск.png]] — поиск по адресу или координатам.

В панели слева настройте отображение списка курьеров:
* выберите из выпадающего списка филиал, курьеров которого нужно просмотреть;
* укажите менеджеров, чьих курьеров нужно отобразить в списке;
* укажите дату планируемой доставки для курьеров. Чтобы курьер отображался в списке, должны быть выполнены следующие условия:
*# В карточке курьера указана дата приема на работу;
*# Для курьера установлено свободное посещение или есть график на дату планирования. Подробнее см. раздел «[[Графики работы сотрудников]]».

В окне справа отображается карта с адресами отправлений, отмеченными [[Модуль «Карта»#Настройка карты|маркерами]].

===Ненайденные адреса ===

Адреса, которые не удалось найти на карте, отображаются в нижней части окна.

Если адрес не отображается на карте:
* щелкните дважды по строке ненайденного адреса и в карточке корреспонденции проверьте правильность написания соответствие [[Знакомство с программой#Ввод адресной информации|правилам ввода адресной информации]];
* в контекстном меню списка ненайденных адресов выберите '''Поискать адрес на карте'''. Если адрес найден, перетащите запись из нижней части окна на точку, найденную на карте;
* в контекстном меню списка ненайденных адресов выберите '''Поискать адрес в интернете'''. Откроется окно браузера по умолчанию с адресом на карте. Скопируйте координаты найденного адреса, вставьте в строку поиска сверху и нажмите на кнопку [[Файл:Кнопка_Поиск.png]]. На карте отобразится найденный адрес в виде зеленого ромба. Перетащите запись из нижней части окна на точку, найденную на карте. Изображение ромба пропадет, если удалить из строки поиска координаты его широты и долготы;
* если вы точно знаете местоположение ненайденного адреса на карте, перетащите адрес в нужное место.

Если маркер корреспонденции отмечен не на том месте, открепите точку через контекстное меню (адрес перенесется в «ненайденные»), а затем перетащите на нужное место.

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

=== Настройки===

Настройки вызываются по нажатию на [[Файл:Settings.png]]. Окно настроек выглядит следующим образом:

[[Файл:Карта_маркеры.png|none|300px]]

====Настройка карты====

Вкладка предназначена для установки отображения корреспонденции на карте. Вы можете выбрать один из вариантов:
* '''Цвета состояния''' — корреспонденция отмечается в зависимости от ее статуса. Можно изменить цвета, выбранные по умолчанию. Чтобы изменить цвет, нажмите на кнопку [[Файл:More.png]] справа от цвета, откроется окно с вариантами. Выберите нужный и нажмите '''ОК'''. Этот режим помогает логисту видеть запланированные и незапланированные на курьеров доставки;
*''' Цвета курьеров''' — корреспонденция отображается цветом назначенного курьеру маркера. Предусмотрено 24 разных цвета для курьеров. Если все цвета уже назначены, всем последующим курьерам присваивается белый цвет. Этот режим помогает видеть район доставки корреспонденции на карте при относительно небольшом количестве курьеров.

===== Группировка адресов =====

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

Цветовая схема маркеров помогает быстрее оценить состояние планирования:

* '''Чёрный круг''' — не все адреса в точке запланированы на курьеров.
Пример: текст ''5/10'' означает, что из 10 адресов запланировано только 5.

* '''Зелёный круг''' — все адреса в точке распределены между курьерами.

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

* '''Жёлтый круг''' — в точке есть адреса, закреплённые за выбранным курьером.
Пример: текст ''1/10'' — на выбранного курьера назначен 1 адрес из 10.

* '''Красный круг''' — у выбранного курьера есть адреса в этой точке, и часть остальных адресов пока не запланирована.
Такие адреса можно «докинуть» курьеру, так как он всё равно посещает эту точку.
Пример: текст ''3/10'' — на выбранного курьера запланировано 3 адреса из 10.

* '''Двухцветный круг''' , одна половина '''черная''', другая '''красная''' - в точке адреса запланированы, но на разных курьеров.

==== Печать ====

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

Чтобы улучшить качество изображения, введите коэффициент усиления контрастности печати.

Варианты печати карты:
* печать карты из окна «Карта». Слева вверху нажмите на кнопку '''Печать''';
* автоматическая печать. Позволяет распечатывать карту вместе с документами, необходимыми при выдаче корреспонденции. Можно <rspoiler text="настроить печать">'''Справочники''' > '''Переменные''' > '''Печать''' > '''Печатать карту при выдаче'''. Возможные значения: '''Не печатать''', '''Печатать после акта''' (если нужно нумеровать корреспонденцию на печатной карте) и '''Печатать до акта''' (если нужно нумеровать адреса на печатной карте).</rspoiler>до выдачи или после выдачи акта.

Существуют следующие варианты обозначения корреспонденции на печатной карте при выдаче:
* нумеруется корреспонденция. Внутри каждого квадрата находится порядковый номер корреспонденции из акта приема-передачи курьеру. Если получателю предназначены несколько отправлений, на карте в квадрате будут перечислены их порядковые номера из акта приема-передачи. Такой вид отображения удобен, когда курьеру нужно сообщить логисту о передаче корреспонденции получателю. Курьер сообщает номер корреспонденции, логист отмечает передачу в программе. <spoiler text="Настройка переменной">
'''Справочники''' > '''Настройка''' > '''Печать''' > '''Акты передачи курьеру''' > '''Сохранять номер строки в акте передачи курьеру''' > '''Запоминать из актов'''</spoiler>
* нумеруются адреса корреспонденции. Внутри каждого квадрата находится порядковый номер адреса. Если получателей несколько на один адрес, на вкладке '''Выдача''' в графе '''Номер в акте''' у нескольких корреспонденций будет один порядковый номер.<spoiler text="Настройка переменной">'''Справочники''' > '''Настройка''' > '''Печать''' > '''Акты передачи курьеру''' > '''Сохранять номер строки в акте передачи курьеру''' > '''Запоминать из карт'''</spoiler>Пример карты:
[[Файл:Печать на карте.jpg|500px|none]]

==== Хинты ====

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

Всплывающие подсказки настраиваются отдельно для отображения карты в разных режимах:
* по кнопке '''Адреса ''' — подсказки на вкладке '''Адреса''';
* по кнопке '''Трекинг''' — подсказки при просмотре маршрута курьера в [[Функции#Трекинг курьеров|трекинге]];
* по кнопке '''Выдача в трекинге''' — подсказки при просмотре выданной корреспонденции в [[Функции#Трекинг курьеров|трекинге]].

=== Дополнительные возможности ===

В программе предусмотрены параметры, которые позволяют задать условия отображения маркера на карте. Например, можно сделать заборы большими синими треугольниками, а вечерние доставки отображать маленькими желтыми квадратиками. Подробнее см. раздел [[Системные доп. возможности#Настройка вида маркера | «Руководство программиста»]].

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

=Виды планирования=
* Планирование по курьерам с помощью карт:
** [[Модуль «Карта»#Ручное планирование|вручную]]
** [[Модуль «Карта»#Планирование схемами|схемы]]
** позаказно
* Планирование по списку
* Планирование маршрутов курьеров:
**[[#Ручное планирование маршрутов|ручное планирование маршрутов]]
** автоматическое планирование [[Максоптра]]
** автоматическое планирование [[Яндекс.Маршрутизация]]

=== Ручное планирование по курьерам ===
Виды ручного планирования:
* назначение курьера на маркер. В контекстном меню маркера корреспонденции выберите '''Запланировать'''. Заказ планируется на сотрудника, выбранного в списке слева. По умолчанию это первый в списке курьер. Чтобы выбрать конкретного курьера, в контекстном меню маркера выберите '''Запланировать для курьера''';
* перемещение маркеров. Например, курьер на доставку запланирован, нужно добавить ему еще отправления. Удерживая нажатой кнопку CTRL, перетащите свободный маркер на маркер c запланированным сотрудником. В результате два адреса планируются для доставки одним сотрудником. Если на обоих маркерах уже запланированы курьеры, при перемещении одного на другой отправление будет назначено сотруднику, на маркер которого перетащили;
* выделение области. Удерживая нажатой правую кнопку мыши, обведите область с маркерами, затем в контекстном меню области выберите пункт '''Запланировать для курьера'''. В результате отправления этой области назначена на доставку указанному сотруднику.

=== Планирование схемами по курьерам ===
;Схемы
: Графически выделенные контуры районов доставки, сохраненные на карте, возможно, с назначенными на них курьерами.

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

[[Файл:зонирование.png|none]]

==== Создание схемы ====
# Выберите заказы, перейдите на вкладку '''Адреса''' и нажмите на кнопку [[Файл:Показать на карте.jpg|30 px]]. Откроется окно «Карта».
# Нажмите на кнопку '''Добавить'''.
# В выпадающем списке выберите добавленную схему.
# Нажмите на кнопку [[Файл:Кнопка Опции.png]] рядом с кнопкой '''Добавить''' и выберите пункт '''Редактировать схему'''.
# В контекстном меню на карте выберите пункт '''Создать контур'''. Подробнее см. раздел «[[Зоны на карте#Создание контуров на карте|Создание контуров на карте]]».
# При помощи правой клавиши мыши выставляйте точки контура так, чтобы получилась замкнутая область. Когда контур готов, нажмите ENTER. Чтобы объединить соседние контуры, выделите их, удерживая зажатой клавишу CTRL, и в контекстном меню выберите '''Объединить контуры'''.
# Чтобы назначить курьера на контур, в контекстном меню выберите пункт '''Установить курьера'''.
# Создайте столько контуров с назначенными курьерами, сколько нужно для работы, и нажмите на кнопку '''Завершить'''.
# Нажмите на кнопку [[Файл:Кнопка Опции.png]] рядом с кнопкой '''Добавить''' и выберите пункт '''Параметры схемы'''. В открывшемся окне укажите название схемы и выберите филиал, к которому будет относиться схема.

Пункт контекстного меню '''Указать номер зоны''' используется в клиентской автоматизации, не входящей в стандартную поставку. <spoiler text="Подробнее">Автоматизация создает начисления, компенсирующие курьерам затраты на ГСМ. Зонам на схеме присваивается номер, соответствующий размеру компенсации ГСМ. Например, номер зоны 200 означает, что компенсация равна 200 рублям. Автоматизация учитывает вчерашние выдачи со статусами «Отказ на месте» и «Доставлено», начисляет компенсацию каждому курьеру по самой удаленной зоне доставки и выводит сумму к выдаче в АПК.</spoiler>
При создании контуров не допускайте пустоты и пересечения контуров. Если адрес доставки или забора попадет в пустое место между контурами, то в режиме [[Модуль Карта#Полуавтоматическое планирование|полуавтоматического планирования]] ни один курьер не будет назначен на доставку. Если адрес попадет на пересечение контуров, то курьер будет выбран случайно из назначенных на пересекающиеся области.

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

==== Планирование ====
Чтобы начать планирование, в окне «Карта» выберите [[#Создание схемы|созданную схему]] из выпадающего списка и нажмите на кнопку '''Проставить по всем'''. Корреспонденция распределится между работающими курьерами, по завершении операции формируется отчёт в отдельном окне. Можно использовать способы [[#Ручное планирование|ручного планирования]].

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

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

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

==== Удаление схемы ====
В окне «Карта» выберите схему из выпадающего списка, нажмите на кнопку [[Файл:Кнопка Опции.png]] рядом с кнопкой '''Добавить''' и выберите пункт '''Удалить схему'''.

===Ручное планирование маршрутов===

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

# В окне «Карта» нажмите на кнопку '''Доставка'''. Если есть корреспонденции, запланированные на курьера на указанную дату, маршруты автоматически сформируются и отобразятся на карте. Точки в маршрутах располагаются в случайном порядке.
# [[#Запланировано|Скорректируйте]] маршруты при необходимости и нажмите на кнопку '''Подтвердить все маршруты'''. Номера точек в маршруте заносятся в [[путевые листы]].

[[Файл:Ручная маршрутизация.png|none|1500 px]]

Информация в панели '''Доставка''' сгруппирована по вкладкам:
* Запланировано — общая информация о сформированных маршрутах. Поля «Отбытие», «Прибытие», «КМ» не заполняются;
* Не запланировано — список отправлений, которые не запланированы на курьера или на дату или не найдены на карте.

Вы можете использовать способы [[#Ручное планирование|ручного планирования]] на карте для указания курьера.

====Запланировано====
В таблице «Маршруты» содержится общая информация о сформированных маршрутах.

Возможные действия:
* добавить новый маршрут для курьера, еще не указанного в списке — в контекстном меню выберите '''Создать новый маршрут''' и укажите сотрудника;
* запланировать сформированный маршрут для выбранного курьера — в контекстном меню выберите '''Запланировать''';
* назначить другого курьера для сформированного маршрута — в контекстном меню выберите '''Запланировать для курьера'''.

В таблице «Адреса» перечислены точки, входящие в маршрут курьера, выделенного в таблице «Маршруты» выше. Точки в маршрутах располагаются в случайном порядке. Вы можете перемещать точки:
* внутри маршрута — комбинацией клавиш ВВЕРХ + CTRL и ВНИЗ + CTRL или с помощью пунктов контекстного меню '''Передвинуть выше''' и '''Передвинуть ниже''';
* между маршрутами — используйте пункт контекстного меню '''Переместить в маршрут'''. Точка добавляется в конец списка адресов.

Выделенная в списке точка подсвечивается в маршруте на карте.

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

Чтобы подтвердить сформированные маршруты, нажмите на кнопку '''Подтвердить все маршруты'''. Номера точек в маршруте заносятся в [[путевые листы]].

====Не запланировано====

Вкладка содержит список отправлений с ошибками планирования. Строки выделены розовым цветом, при наведении курсора мыши на строку или в столбце «Примечание» отображается подсказка с причиной ошибки:
* не запланирован на курьера — используйте пункт контекстного меню '''Переместить в маршрут'''. Точка добавляется в конец списка адресов маршрута;
* не подходит план. дата доставки — откройте корреспонденцию щелчком по строке и исправьте дату доставки;
* местоположение не подтверждено — выполните действия, описанные в разделе [[#Ненайденные адреса|«Ненайденные адреса»]];
* курьер не доступен по графику — убедитесь, что в карточке курьера есть [[Графики работы сотрудников|график]] на дату планирования.

=== Автоматическое планирование ===
Вид планирования, который позволяет автоматизировать назначение курьеров и просчет оптимальных маршрутов доставки корреспонденции с учетом дорожных условий.

В MeaSoft доступны интеграции с сервисами автоматического планирования:
* [[Maxoptra]]
* [[Яндекс.Маршрутизация]]

= Картографическая система =

Программа MeaSoft работает с картографической системой [http://www.openstreetmap.org '''OpenStreetMap'''].

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

Карты OpenStreetMap позволяют создавать области и тарифицировать зоны, назначать курьеров в окне '''Карта''', планировать курьеров на доставку.

OpenStreetMap не умеет строить маршруты курьеров, для работы с новыми областями необходимо постоянное подключение к интернету. Просмотренные области карты [[Терминология#Карта|кешируются]] и в дальнейшем доступны для работы даже без интернета.

Система OpenstreetMap в программе MeaSoft не требует никакой региональной настройки и сразу готова к работе.

= Геокодирование =

== Описание и принцип работы ==
Для отображения любой информации на карте используется [https://ru.wikipedia.org/wiki/Геокодирование геокодирование].

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

При записи и чтении из кэша срабатывает упрощение адреса: до первой запятой — считается улицей, 5 символов после — номер дома. Использование упрощения адресов определяется переменной '''Справочники''' > '''Переменные''' > '''Подключения''' > '''Карты''' > '''Геокодирование''' > '''Отключить упрощение адреса при геокодировании''':
* если упрощение включено, в кеш записывается не весь найденный адрес, а только часть. Перед поиском адрес также сначала упрощается. Например, адрес вида «Солнечногорск, улица Островского, 1» и «Солнечногорск, улица Гоголя, 1» упрощается до «Солнечногорск, улица». И программа оба адреса сведет к одной точке. При включении упрощения точность до дома не гарантируется;
* если упрощение адреса выключено, поиск и запись адреса в кеш ведется в том виде, в каком он указан, и время определения координат может увеличиться. При разнице хотя бы в один символ нужен повторный запрос к геокодеру. Например, эти адреса будут разными: «Солнечногорск, улица Островского, 1» и «Солнечногорск, улица Островского, д1».

Для улучшения результатов геокодирования при включенном упрощении указывайте адрес по стандарту MeaSoft. Например, в поле '''Адрес''' нужно указать «улица Островского, 1», а в поле '''Город''' указать «Солнечногорск». Тогда точность будет высокой при хорошей скорости геокодирования.

Если геокодер MeaSoft не нашел адрес, он может сделать запрос к платному геокодеру: [https://www.ahunter.ru/ Ахантер] и к [https://yandex.ru/maps Яндекс. Картам]. Сервер геокодирования Яндекс. Карт, получая запрос, преобразует адреса в координаты и ищет соответствия по своей базе данных, затем возвращает адреса в программу. В окне «Карта» отображаются маркеры адресов, которым сервер Яндекс. Карт смог найти соответствия.

== Настройка ==
Данные сервера геокодирования Яндекс.Карт находятся в '''Справочники''' > '''Переменные''' > '''Подключения''' > '''Карты''' > '''Яндекс''' > '''Сервер геокодирования Яндекс'''.

Чтобы адреса корректно определялись на карте, перейдите по [https://developer.tech.yandex.ru/ ссылке] и получите ключ «JavaScript API и HTTP Геокодер», затем укажите его в '''Справочники''' > '''Переменные''' > '''Подключения''' > '''Карты''' > '''Геокодирование''' > '''API-Ключ'''.

== Лимиты геокодирования Яндекс.Карт ==
Из-за существенного уменьшения лимитов запросов Яндексом - в данный момент в сутки на общий АПИ ключ дается только 1000 запросов на всех пользователей сервиса.
Для увеличения лимитов вы можете добавить свой АПИ ключ Яндекса.

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

=Единое районирование=

;Единое районирование
:Cистема планирования работы курьеров, при которой заказы распределяются по районам, нарисованным на карте. Этот метод пришел на смену планированию по станциям метро. Единое районирование работает для всех филиалов компании.

Чтобы включить единое районирование:
# Выберите '''Справочники''' > '''Переменные''' > '''Финансы''' > '''Расчет района по адресу''', установите значение переменной '''1''' и нажмите '''Сохранить'''. При этом автоматически включатся связанные переменные '''Расчет стоимости по адресу''' и '''Расчет зоны курьера по адресу'''.
#: Можно включить единое районирование для отдельных пользователей. Для этого после 0 укажите через запятую <rspoiler text=имена>'''Настройки''' > '''Пользователи''' > карточка пользователя > поле '''Имя пользователя''' </rspoiler> конкретных пользователей и нажмите '''Сохранить''':[[Файл:Edinoe raionirovanie.png|none|700px]]
# Выберите '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Планировать по курьерам в режиме многофилиальности'''. Возможные значения переменной:
#* '''0''' — адреса на карте планируются по районам, в окне слева будет отображаться список районов;
#* '''1''' — адреса на карте планируются по курьерам, в окне слева будет отображаться список курьеров.
#: Чтобы внедрять функциональность в работу постепенно, в переменных можно указать отдельных пользователей аналогично действиям в пункте 1.
#: Установите значение переменной и нажмите '''Сохранить'''.
# Выберите '''Справочники''' > '''Переменные''' > '''Умолчания''' > '''Псевдоним метро''' и введите название, которое заменит слово «метро» в интерфейсе программы. Например, «районы».
# После изменения значения переменных перезагрузите программу MeaSoft.
После включения единого районирования станут недоступны справочники '''Метро''', '''Улицы''', планирование по станциям метро. Чтобы установить тарифные зоны:
# Выберите '''Справочники''' > '''Районы''', нарисуйте районы доставки на карте и закрепите за ними курьеров для автоматического планирования.
# Выберите '''Справочники''' > '''Зоны на карте''' и нарисуйте зоны курьеров и/или клиентов. Подробнее см. раздел [[Зоны на карте|«Зоны на карте»]].

По завершении всех настроек на вкладке '''Адреса''' выделите несколько адресов и нажмите на кнопку [[Файл:Показать на карте.jpg|30 px]]. В зависимости от значения переменной '''Планировать по курьерам в режиме многофилиальности''' на карте в окне слева отобразится список курьеров или районов доставки. Если отображается неполный список курьеров, перейдите в карточку отсутствующего в списке сотрудника и проверьте, указаны ли у него дата приема на работу и график работы.

<spoiler text="См. также">
[[Графики работы сотрудников]]</spoiler>

Модуль «Карта»

2026-03-25T06:54:53Z

Sammy: /* Группировка адресов */

== Назначение ==

Модуль предназначен для визуального планирования городских доставок и создания [[Зоны на карте|тарифных зон]] на карте в режиме [[#Единое районирование|единого районирования]].

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

На вкладке '''Заказы''' выделите заказы и нажмите на клавишу ПРОБЕЛ или выберите пункт контекстного меню '''Перейти к адресам'''. На вкладке '''Адреса''' отобразятся отправления, которые нужно доставить или забрать. Для удобства список корреспонденции можно [[Основные принципы работы в программе#Сортировка списка адресов|отсортировать]].

Чтобы открыть заказы на карте, на вкладке '''Адреса''' нажмите на кнопку [[Файл:Показать на карте.jpg|30 px]]. Чтобы посмотреть определенное отправление, выделите его и выберите пункт контекстного меню '''Показать на карте'''.

Откроется окно «Карта»:

[[Файл:Карта.png|none]]

Верхнее меню содержит следующие кнопки:

[[Файл:Globe.png]] — обзор всей карты;

[[Файл:Print.png]] — печать видимого участка карты;

[[Файл:Settings.png]] — [[Модуль «Карта»#Настройки|настройки отображения]] информации на карте;

[[Файл:Кнопка_Поиск.png]] — поиск по адресу или координатам.

В панели слева настройте отображение списка курьеров:
* выберите из выпадающего списка филиал, курьеров которого нужно просмотреть;
* укажите менеджеров, чьих курьеров нужно отобразить в списке;
* укажите дату планируемой доставки для курьеров. Чтобы курьер отображался в списке, должны быть выполнены следующие условия:
*# В карточке курьера указана дата приема на работу;
*# Для курьера установлено свободное посещение или есть график на дату планирования. Подробнее см. раздел «[[Графики работы сотрудников]]».

В окне справа отображается карта с адресами отправлений, отмеченными [[Модуль «Карта»#Настройка карты|маркерами]].

===Ненайденные адреса ===

Адреса, которые не удалось найти на карте, отображаются в нижней части окна.

Если адрес не отображается на карте:
* щелкните дважды по строке ненайденного адреса и в карточке корреспонденции проверьте правильность написания соответствие [[Знакомство с программой#Ввод адресной информации|правилам ввода адресной информации]];
* в контекстном меню списка ненайденных адресов выберите '''Поискать адрес на карте'''. Если адрес найден, перетащите запись из нижней части окна на точку, найденную на карте;
* в контекстном меню списка ненайденных адресов выберите '''Поискать адрес в интернете'''. Откроется окно браузера по умолчанию с адресом на карте. Скопируйте координаты найденного адреса, вставьте в строку поиска сверху и нажмите на кнопку [[Файл:Кнопка_Поиск.png]]. На карте отобразится найденный адрес в виде зеленого ромба. Перетащите запись из нижней части окна на точку, найденную на карте. Изображение ромба пропадет, если удалить из строки поиска координаты его широты и долготы;
* если вы точно знаете местоположение ненайденного адреса на карте, перетащите адрес в нужное место.

Если маркер корреспонденции отмечен не на том месте, открепите точку через контекстное меню (адрес перенесется в «ненайденные»), а затем перетащите на нужное место.

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

=== Настройки===

Настройки вызываются по нажатию на [[Файл:Settings.png]]. Окно настроек выглядит следующим образом:

[[Файл:Карта_маркеры.png|none|300px]]

====Настройка карты====

Вкладка предназначена для установки отображения корреспонденции на карте. Вы можете выбрать один из вариантов:
* '''Цвета состояния''' — корреспонденция отмечается в зависимости от ее статуса. Можно изменить цвета, выбранные по умолчанию. Чтобы изменить цвет, нажмите на кнопку [[Файл:More.png]] справа от цвета, откроется окно с вариантами. Выберите нужный и нажмите '''ОК'''. Этот режим помогает логисту видеть запланированные и незапланированные на курьеров доставки;
*''' Цвета курьеров''' — корреспонденция отображается цветом назначенного курьеру маркера. Предусмотрено 24 разных цвета для курьеров. Если все цвета уже назначены, всем последующим курьерам присваивается белый цвет. Этот режим помогает видеть район доставки корреспонденции на карте при относительно небольшом количестве курьеров.

===== Группировка адресов =====

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

Цветовая схема маркеров помогает быстрее оценить состояние планирования:

* '''Чёрный круг''' — не все адреса в точке запланированы на курьеров.
Пример: текст ''5/10'' означает, что из 10 адресов запланировано только 5.

* '''Зелёный круг''' — все адреса в точке распределены между курьерами.

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

* '''Жёлтый круг''' — в точке есть адреса, закреплённые за выбранным курьером.
Пример: текст ''1/10'' — на выбранного курьера назначен 1 адрес из 10.

* '''Красный круг''' — у выбранного курьера есть адреса в этой точке, и часть остальных адресов пока не запланирована.
Такие адреса можно «докинуть» курьеру, так как он всё равно посещает эту точку.
Пример: текст ''3/10'' — на выбранного курьера запланировано 3 адреса из 10.

* Двухцветный круг , одна половина '''черная''', другая '''красная''' - в точке адреса запланированы, но на разных курьеров.

==== Печать ====

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

Чтобы улучшить качество изображения, введите коэффициент усиления контрастности печати.

Варианты печати карты:
* печать карты из окна «Карта». Слева вверху нажмите на кнопку '''Печать''';
* автоматическая печать. Позволяет распечатывать карту вместе с документами, необходимыми при выдаче корреспонденции. Можно <rspoiler text="настроить печать">'''Справочники''' > '''Переменные''' > '''Печать''' > '''Печатать карту при выдаче'''. Возможные значения: '''Не печатать''', '''Печатать после акта''' (если нужно нумеровать корреспонденцию на печатной карте) и '''Печатать до акта''' (если нужно нумеровать адреса на печатной карте).</rspoiler>до выдачи или после выдачи акта.

Существуют следующие варианты обозначения корреспонденции на печатной карте при выдаче:
* нумеруется корреспонденция. Внутри каждого квадрата находится порядковый номер корреспонденции из акта приема-передачи курьеру. Если получателю предназначены несколько отправлений, на карте в квадрате будут перечислены их порядковые номера из акта приема-передачи. Такой вид отображения удобен, когда курьеру нужно сообщить логисту о передаче корреспонденции получателю. Курьер сообщает номер корреспонденции, логист отмечает передачу в программе. <spoiler text="Настройка переменной">
'''Справочники''' > '''Настройка''' > '''Печать''' > '''Акты передачи курьеру''' > '''Сохранять номер строки в акте передачи курьеру''' > '''Запоминать из актов'''</spoiler>
* нумеруются адреса корреспонденции. Внутри каждого квадрата находится порядковый номер адреса. Если получателей несколько на один адрес, на вкладке '''Выдача''' в графе '''Номер в акте''' у нескольких корреспонденций будет один порядковый номер.<spoiler text="Настройка переменной">'''Справочники''' > '''Настройка''' > '''Печать''' > '''Акты передачи курьеру''' > '''Сохранять номер строки в акте передачи курьеру''' > '''Запоминать из карт'''</spoiler>Пример карты:
[[Файл:Печать на карте.jpg|500px|none]]

==== Хинты ====

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

Всплывающие подсказки настраиваются отдельно для отображения карты в разных режимах:
* по кнопке '''Адреса ''' — подсказки на вкладке '''Адреса''';
* по кнопке '''Трекинг''' — подсказки при просмотре маршрута курьера в [[Функции#Трекинг курьеров|трекинге]];
* по кнопке '''Выдача в трекинге''' — подсказки при просмотре выданной корреспонденции в [[Функции#Трекинг курьеров|трекинге]].

=== Дополнительные возможности ===

В программе предусмотрены параметры, которые позволяют задать условия отображения маркера на карте. Например, можно сделать заборы большими синими треугольниками, а вечерние доставки отображать маленькими желтыми квадратиками. Подробнее см. раздел [[Системные доп. возможности#Настройка вида маркера | «Руководство программиста»]].

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

=Виды планирования=
* Планирование по курьерам с помощью карт:
** [[Модуль «Карта»#Ручное планирование|вручную]]
** [[Модуль «Карта»#Планирование схемами|схемы]]
** позаказно
* Планирование по списку
* Планирование маршрутов курьеров:
**[[#Ручное планирование маршрутов|ручное планирование маршрутов]]
** автоматическое планирование [[Максоптра]]
** автоматическое планирование [[Яндекс.Маршрутизация]]

=== Ручное планирование по курьерам ===
Виды ручного планирования:
* назначение курьера на маркер. В контекстном меню маркера корреспонденции выберите '''Запланировать'''. Заказ планируется на сотрудника, выбранного в списке слева. По умолчанию это первый в списке курьер. Чтобы выбрать конкретного курьера, в контекстном меню маркера выберите '''Запланировать для курьера''';
* перемещение маркеров. Например, курьер на доставку запланирован, нужно добавить ему еще отправления. Удерживая нажатой кнопку CTRL, перетащите свободный маркер на маркер c запланированным сотрудником. В результате два адреса планируются для доставки одним сотрудником. Если на обоих маркерах уже запланированы курьеры, при перемещении одного на другой отправление будет назначено сотруднику, на маркер которого перетащили;
* выделение области. Удерживая нажатой правую кнопку мыши, обведите область с маркерами, затем в контекстном меню области выберите пункт '''Запланировать для курьера'''. В результате отправления этой области назначена на доставку указанному сотруднику.

=== Планирование схемами по курьерам ===
;Схемы
: Графически выделенные контуры районов доставки, сохраненные на карте, возможно, с назначенными на них курьерами.

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

[[Файл:зонирование.png|none]]

==== Создание схемы ====
# Выберите заказы, перейдите на вкладку '''Адреса''' и нажмите на кнопку [[Файл:Показать на карте.jpg|30 px]]. Откроется окно «Карта».
# Нажмите на кнопку '''Добавить'''.
# В выпадающем списке выберите добавленную схему.
# Нажмите на кнопку [[Файл:Кнопка Опции.png]] рядом с кнопкой '''Добавить''' и выберите пункт '''Редактировать схему'''.
# В контекстном меню на карте выберите пункт '''Создать контур'''. Подробнее см. раздел «[[Зоны на карте#Создание контуров на карте|Создание контуров на карте]]».
# При помощи правой клавиши мыши выставляйте точки контура так, чтобы получилась замкнутая область. Когда контур готов, нажмите ENTER. Чтобы объединить соседние контуры, выделите их, удерживая зажатой клавишу CTRL, и в контекстном меню выберите '''Объединить контуры'''.
# Чтобы назначить курьера на контур, в контекстном меню выберите пункт '''Установить курьера'''.
# Создайте столько контуров с назначенными курьерами, сколько нужно для работы, и нажмите на кнопку '''Завершить'''.
# Нажмите на кнопку [[Файл:Кнопка Опции.png]] рядом с кнопкой '''Добавить''' и выберите пункт '''Параметры схемы'''. В открывшемся окне укажите название схемы и выберите филиал, к которому будет относиться схема.

Пункт контекстного меню '''Указать номер зоны''' используется в клиентской автоматизации, не входящей в стандартную поставку. <spoiler text="Подробнее">Автоматизация создает начисления, компенсирующие курьерам затраты на ГСМ. Зонам на схеме присваивается номер, соответствующий размеру компенсации ГСМ. Например, номер зоны 200 означает, что компенсация равна 200 рублям. Автоматизация учитывает вчерашние выдачи со статусами «Отказ на месте» и «Доставлено», начисляет компенсацию каждому курьеру по самой удаленной зоне доставки и выводит сумму к выдаче в АПК.</spoiler>
При создании контуров не допускайте пустоты и пересечения контуров. Если адрес доставки или забора попадет в пустое место между контурами, то в режиме [[Модуль Карта#Полуавтоматическое планирование|полуавтоматического планирования]] ни один курьер не будет назначен на доставку. Если адрес попадет на пересечение контуров, то курьер будет выбран случайно из назначенных на пересекающиеся области.

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

==== Планирование ====
Чтобы начать планирование, в окне «Карта» выберите [[#Создание схемы|созданную схему]] из выпадающего списка и нажмите на кнопку '''Проставить по всем'''. Корреспонденция распределится между работающими курьерами, по завершении операции формируется отчёт в отдельном окне. Можно использовать способы [[#Ручное планирование|ручного планирования]].

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

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

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

==== Удаление схемы ====
В окне «Карта» выберите схему из выпадающего списка, нажмите на кнопку [[Файл:Кнопка Опции.png]] рядом с кнопкой '''Добавить''' и выберите пункт '''Удалить схему'''.

===Ручное планирование маршрутов===

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

# В окне «Карта» нажмите на кнопку '''Доставка'''. Если есть корреспонденции, запланированные на курьера на указанную дату, маршруты автоматически сформируются и отобразятся на карте. Точки в маршрутах располагаются в случайном порядке.
# [[#Запланировано|Скорректируйте]] маршруты при необходимости и нажмите на кнопку '''Подтвердить все маршруты'''. Номера точек в маршруте заносятся в [[путевые листы]].

[[Файл:Ручная маршрутизация.png|none|1500 px]]

Информация в панели '''Доставка''' сгруппирована по вкладкам:
* Запланировано — общая информация о сформированных маршрутах. Поля «Отбытие», «Прибытие», «КМ» не заполняются;
* Не запланировано — список отправлений, которые не запланированы на курьера или на дату или не найдены на карте.

Вы можете использовать способы [[#Ручное планирование|ручного планирования]] на карте для указания курьера.

====Запланировано====
В таблице «Маршруты» содержится общая информация о сформированных маршрутах.

Возможные действия:
* добавить новый маршрут для курьера, еще не указанного в списке — в контекстном меню выберите '''Создать новый маршрут''' и укажите сотрудника;
* запланировать сформированный маршрут для выбранного курьера — в контекстном меню выберите '''Запланировать''';
* назначить другого курьера для сформированного маршрута — в контекстном меню выберите '''Запланировать для курьера'''.

В таблице «Адреса» перечислены точки, входящие в маршрут курьера, выделенного в таблице «Маршруты» выше. Точки в маршрутах располагаются в случайном порядке. Вы можете перемещать точки:
* внутри маршрута — комбинацией клавиш ВВЕРХ + CTRL и ВНИЗ + CTRL или с помощью пунктов контекстного меню '''Передвинуть выше''' и '''Передвинуть ниже''';
* между маршрутами — используйте пункт контекстного меню '''Переместить в маршрут'''. Точка добавляется в конец списка адресов.

Выделенная в списке точка подсвечивается в маршруте на карте.

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

Чтобы подтвердить сформированные маршруты, нажмите на кнопку '''Подтвердить все маршруты'''. Номера точек в маршруте заносятся в [[путевые листы]].

====Не запланировано====

Вкладка содержит список отправлений с ошибками планирования. Строки выделены розовым цветом, при наведении курсора мыши на строку или в столбце «Примечание» отображается подсказка с причиной ошибки:
* не запланирован на курьера — используйте пункт контекстного меню '''Переместить в маршрут'''. Точка добавляется в конец списка адресов маршрута;
* не подходит план. дата доставки — откройте корреспонденцию щелчком по строке и исправьте дату доставки;
* местоположение не подтверждено — выполните действия, описанные в разделе [[#Ненайденные адреса|«Ненайденные адреса»]];
* курьер не доступен по графику — убедитесь, что в карточке курьера есть [[Графики работы сотрудников|график]] на дату планирования.

=== Автоматическое планирование ===
Вид планирования, который позволяет автоматизировать назначение курьеров и просчет оптимальных маршрутов доставки корреспонденции с учетом дорожных условий.

В MeaSoft доступны интеграции с сервисами автоматического планирования:
* [[Maxoptra]]
* [[Яндекс.Маршрутизация]]

= Картографическая система =

Программа MeaSoft работает с картографической системой [http://www.openstreetmap.org '''OpenStreetMap'''].

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

Карты OpenStreetMap позволяют создавать области и тарифицировать зоны, назначать курьеров в окне '''Карта''', планировать курьеров на доставку.

OpenStreetMap не умеет строить маршруты курьеров, для работы с новыми областями необходимо постоянное подключение к интернету. Просмотренные области карты [[Терминология#Карта|кешируются]] и в дальнейшем доступны для работы даже без интернета.

Система OpenstreetMap в программе MeaSoft не требует никакой региональной настройки и сразу готова к работе.

= Геокодирование =

== Описание и принцип работы ==
Для отображения любой информации на карте используется [https://ru.wikipedia.org/wiki/Геокодирование геокодирование].

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

При записи и чтении из кэша срабатывает упрощение адреса: до первой запятой — считается улицей, 5 символов после — номер дома. Использование упрощения адресов определяется переменной '''Справочники''' > '''Переменные''' > '''Подключения''' > '''Карты''' > '''Геокодирование''' > '''Отключить упрощение адреса при геокодировании''':
* если упрощение включено, в кеш записывается не весь найденный адрес, а только часть. Перед поиском адрес также сначала упрощается. Например, адрес вида «Солнечногорск, улица Островского, 1» и «Солнечногорск, улица Гоголя, 1» упрощается до «Солнечногорск, улица». И программа оба адреса сведет к одной точке. При включении упрощения точность до дома не гарантируется;
* если упрощение адреса выключено, поиск и запись адреса в кеш ведется в том виде, в каком он указан, и время определения координат может увеличиться. При разнице хотя бы в один символ нужен повторный запрос к геокодеру. Например, эти адреса будут разными: «Солнечногорск, улица Островского, 1» и «Солнечногорск, улица Островского, д1».

Для улучшения результатов геокодирования при включенном упрощении указывайте адрес по стандарту MeaSoft. Например, в поле '''Адрес''' нужно указать «улица Островского, 1», а в поле '''Город''' указать «Солнечногорск». Тогда точность будет высокой при хорошей скорости геокодирования.

Если геокодер MeaSoft не нашел адрес, он может сделать запрос к платному геокодеру: [https://www.ahunter.ru/ Ахантер] и к [https://yandex.ru/maps Яндекс. Картам]. Сервер геокодирования Яндекс. Карт, получая запрос, преобразует адреса в координаты и ищет соответствия по своей базе данных, затем возвращает адреса в программу. В окне «Карта» отображаются маркеры адресов, которым сервер Яндекс. Карт смог найти соответствия.

== Настройка ==
Данные сервера геокодирования Яндекс.Карт находятся в '''Справочники''' > '''Переменные''' > '''Подключения''' > '''Карты''' > '''Яндекс''' > '''Сервер геокодирования Яндекс'''.

Чтобы адреса корректно определялись на карте, перейдите по [https://developer.tech.yandex.ru/ ссылке] и получите ключ «JavaScript API и HTTP Геокодер», затем укажите его в '''Справочники''' > '''Переменные''' > '''Подключения''' > '''Карты''' > '''Геокодирование''' > '''API-Ключ'''.

== Лимиты геокодирования Яндекс.Карт ==
Из-за существенного уменьшения лимитов запросов Яндексом - в данный момент в сутки на общий АПИ ключ дается только 1000 запросов на всех пользователей сервиса.
Для увеличения лимитов вы можете добавить свой АПИ ключ Яндекса.

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

=Единое районирование=

;Единое районирование
:Cистема планирования работы курьеров, при которой заказы распределяются по районам, нарисованным на карте. Этот метод пришел на смену планированию по станциям метро. Единое районирование работает для всех филиалов компании.

Чтобы включить единое районирование:
# Выберите '''Справочники''' > '''Переменные''' > '''Финансы''' > '''Расчет района по адресу''', установите значение переменной '''1''' и нажмите '''Сохранить'''. При этом автоматически включатся связанные переменные '''Расчет стоимости по адресу''' и '''Расчет зоны курьера по адресу'''.
#: Можно включить единое районирование для отдельных пользователей. Для этого после 0 укажите через запятую <rspoiler text=имена>'''Настройки''' > '''Пользователи''' > карточка пользователя > поле '''Имя пользователя''' </rspoiler> конкретных пользователей и нажмите '''Сохранить''':[[Файл:Edinoe raionirovanie.png|none|700px]]
# Выберите '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Планировать по курьерам в режиме многофилиальности'''. Возможные значения переменной:
#* '''0''' — адреса на карте планируются по районам, в окне слева будет отображаться список районов;
#* '''1''' — адреса на карте планируются по курьерам, в окне слева будет отображаться список курьеров.
#: Чтобы внедрять функциональность в работу постепенно, в переменных можно указать отдельных пользователей аналогично действиям в пункте 1.
#: Установите значение переменной и нажмите '''Сохранить'''.
# Выберите '''Справочники''' > '''Переменные''' > '''Умолчания''' > '''Псевдоним метро''' и введите название, которое заменит слово «метро» в интерфейсе программы. Например, «районы».
# После изменения значения переменных перезагрузите программу MeaSoft.
После включения единого районирования станут недоступны справочники '''Метро''', '''Улицы''', планирование по станциям метро. Чтобы установить тарифные зоны:
# Выберите '''Справочники''' > '''Районы''', нарисуйте районы доставки на карте и закрепите за ними курьеров для автоматического планирования.
# Выберите '''Справочники''' > '''Зоны на карте''' и нарисуйте зоны курьеров и/или клиентов. Подробнее см. раздел [[Зоны на карте|«Зоны на карте»]].

По завершении всех настроек на вкладке '''Адреса''' выделите несколько адресов и нажмите на кнопку [[Файл:Показать на карте.jpg|30 px]]. В зависимости от значения переменной '''Планировать по курьерам в режиме многофилиальности''' на карте в окне слева отобразится список курьеров или районов доставки. Если отображается неполный список курьеров, перейдите в карточку отсутствующего в списке сотрудника и проверьте, указаны ли у него дата приема на работу и график работы.

<spoiler text="См. также">
[[Графики работы сотрудников]]</spoiler>

Дополнительные возможности

2026-03-18T14:18:47Z

Sammy: /* Настройка документов */

== Настройка для печатной документации ==

'''CustomGivnAct''' - Функция позволяет заменить печатную форму, акта передачи материальных ценностей (печать из выдачи) на пользовательскую. Включить использование этой возможности можно в переменных "Справочники" -> "Переменные" -> "Печать" -> "Акты передачи курьеру" -> "Печатная форма акта: Пользовательская".
Объявленные переменные
%code% - коды записей в выдаче которые необходимо распечатать
%docdate% - дата установленная в выдаче
%dockurier% - ФИО курьера показанного в выдаче
%dockurierfull% - Значение выбранного элемента в дереве (если есть выбранный узел дерева , иначе фио курьера)

Пользовательская форма акта, будет печататься только по заказам со статусом "На руках".

'''OnBeforePrintNakls''' - Вызывается перед печатью накладных, содержит %code% - коды всех адресов (через запятую).

'''OnAfterPrintNakls''' - Вызывается после печати накладных, содержит %code% - коды всех адресов (через запятую).

'''OnBeforePrintOneNakl''' - Вызывается перед печатью накладной, содержит %code% - код адреса.

'''OnAfterPrintOneNakl''' - Вызывается после печати накладной, содержит %code% - код адреса.

'''OnBeforePrintSticker''' - Вызывается перед печатью наклейки, содержит %code% - код адреса, %barcode% - ШК наклейки.

'''OnAfterItemPrint''' - Вызывается после печати наклейки из карточки номенклатуры. Поддерживает поля ввода - input. Содержит %code% - код номенклатуры item.code, %Naimen% - наименование, %country% - название страны, %Count% - указанное количество копий к печати.

'''PrintCustomSticker''' - Функция позволяет установить пользовательскую печатную форму для наклеек (из интерфейса "Печать ведомостей/наклеек"). Вызывается если выбран тип наклейки 15 (переменная StickerForm). Содержит %RectLeft%, %RectTop%, %RectRight%, %RectBottom% - границы прямоугольника на холсте принтера, в которые надо печатать (для поддержки табличной печати на A4), %RecNumber% - номер текущей записи датасета, %CurrentBarCode% - ШК, рассчитанный в зависимости от параметров в интерфейсе "Печать ведомостей/наклеек". %ACopyNo% - номер копии, нумерация с 1. %KolvoStr% - Стандартный текст "текущее место/всего мест", с учетом возможной печати этикетки на одно место из нескольких. Также содержит весь датасет, использующийся в других типах наклеек. В момент вызова функции, принтер уже запущен и начат документ, объект TPrinter в функции создавать не нужно, необходимо только создать объект TCanvas, он создастся как ссылка на текущий холст принтера.

'''PrintItemSticker''' - Вызывается перед печатью наклейки из карточки номенклатуры, для возможности распечатать уникальную наклейку для номенклатуры по заложенным в допвозможности условиям. Содержит %clientbar% - ШК наклейки. Если наклейка распечатана из допвозможности возвращает true, в противном случае false и будет распечатана стандартная наклейка, заложенная в системе

'''ChangeSchetDetailQuery''' - Вызывается формировании / пересчете счета. Возвращает строку разбитую через CRLF на две. Первая строка заменяет поля в запросе по детализации счета, вторая меняет строку группировки. Обязательные поля: zakazcnt - кол-во заказов, price - стоимость курьерских услуг, cnt - количество, pr - общая стоимость курьерских услуг.

'''OnAutoPrintManSticker''' - вызывается перед автопечатью сопроводительного документа к манифесту при заполнении номера пломбы (такая возможность включается уставкой печатаемой формы в переменной AutoPrintManSticker), содержит %code% - код манифеста, %mnf_date% - дату манифеста, %transporter% - код перевозчика, %store% - код филиала-получателя манифеста. Если доп.возможность возвращает true - автопечать происходит, false - нет.

'''OnBeforePrintAddresses''' - Вызывается из формы печати ведомостей/наклеек после нажатия на кнопку "ОК", содержит %code% - коды всех адресов (через запятую).

== Настройка всплывающих окон==

'''OnGivnStateChanged''' - Вызывается в транзакции при изменении статуса выдачи. В параметре %code% указан код выдачи. В %pickupDocId% указан код на таблицу docs, документ приема забранных корреспонденций у курьера (доска приема при закрытии забора). Переменная %RetNotScanned% принимает значение true, если при установленной переменной "Запрашивать возвратные документы при приеме" = "Требовать маркировки наклейкой" пользователь не стал сканировать наклейку.

'''OnAfterGivnStateChanged''' - Вызывается после транзакции, при изменении статуса выдачи. В параметре %code% указан код выдачи. В %pickupDocId% указан код на таблицу docs, документ приема забранных корреспонденций у курьера (доска приема при закрытии забора)

'''OnBeforeAddressSave''' - Вызывается перед сохранением изменений в карточке корреспонденции. Код выполняется не в транзакции и есть возможность показывать диалоговые окна. В качестве параметра передан объект fieldlist (объект полный аналог addressrecord в доп. услугах). . Если результат функции -1, то происходит отмена сохранения без ошибки (abort).

'''OnBeforeBaseSave''' - Вызывается перед сохранением изменений в карточке срочного заказа. Код выполняется не в транзакции и есть возможность показывать диалоговые окна. В качестве параметра передан объект fieldlist (объект полный аналог таблицы base). Теги %date_put%, %time_put%, %message% - содержат дату вручения, время вручения и инфо о доставке соответственно. Если результат функции -1, то происходит отмена сохранения без ошибки (abort).

'''OnAfterAddressSave''' - Вызывается после сохранения карточки корреспонденции в транзакции. Тег %code% - равен коду адреса; %Form3FrameMode% равен 1, если корреспонденция заполняется из интерфейса: "Функции - Ввод заявок по фото".

'''OnBarScan''' - Скриптовая обработка штрих-кода перед поиском

'''AfterAddressAcceptance''' - Событие после приема корреспонденции на склад (например,заказы - прием корреспонденции). Код выполняется не в транзакции и есть возможность показывать диалоговые окна. Содержит %Code% - код адреса, %StrBarCode% - отсканированный штрих-код. При вызове из интерфейса доски приема либо приема корреспонденции передается дополнительный тег %NewMass%, который содержит массу проставленную весами, содержит -1 если проставление массы отключено.

'''BeforeAddressAcceptance''' - Событие перед приемом корреспонденции на склад (например,заказы - прием корреспонденции). Код выполняется в транзакции. Содержит %Code% - код адреса; %StrBarCode% - отсканированный штрих-код; %mass% - массу, если значение меньше 0 значит весы выключены; %l%, %w%, %h% - габариты; %MultiBarCode% - истина если это наклейка на место; %SetKolvo% - проставлять принятые места, место может быть уже принято; %ClientCode% - код клиента (clients.code); %PackCode% - код места (packages.code) . Если функция возвращает значение больше 0, то это будет новой массой места или корреспонденции.

'''OnAddToShippingPlace''' - событие после добавления корреспонденции в мешок манифеста. Код выполняется в транзакции. Содержит %сode% - код адреса, %BarCode% - штрих код который отсканировали,%ShippingPlace% - код мешка

'''GetTypeShippingPlace''' - событие перед добавлением корреспонденции в мешок манифеста. Задача события распределить корреспонденцию между мешками. Результат функции код мешка, в который необходимо поместить корреспонденцию. Содержит %сode% - код адреса.

'''OnBeforePlanToManifest''' - событие перед планированием корреспонденции в манифест. Предназначено для дополнительных проверок. Выполняется до транзакции. Содержит %code% - код манифеста, %AddrList% - список кодов адресов через запятую. Объявление события отменяет системную проверку на возможность доставки адреса филиалом получателя, ее нужно реализовывать в этом событии.

'''OnBeforeScanToManifest''' - событие перед добавлением корреспонденции в мешок манифеста. Предназначено для дополнительных проверок. Выполняется до транзакции. Содержит %code% - код манифеста, %Address% - код помещаемого адреса

'''OnBeforePlanning''' - событие перед планированием одного или нескольких отправлений на курьера. Содержит %сode% - код курьера, %AddressCodes% - код(ы) планируемых корреспонденций.

'''OnAfterPlanning'''- событие после планирования планированием одного или нескольких отправлений на курьера. Содержит %сode% - код курьера, %AddressCodes% - код(ы) фактически запланированных корреспонденций.

'''DAILY''' - задание выполняемое один раз в день

'''OnGivnKurierStateChanged''' - событие вызывается после изменений данных со слов курьера (статуса, времени или причины недоставки). Вызывается даже при получении данных из мобильного приложения курьера. В событии запрещено показывать диалоги, т.к. это может остановить синхронизацию данных с ЛК. Содержит %сode% - код выдачи.

'''OnBeforeGivnStatus''' - событие срабатывает перед установкой статуса выдачи, не в транзакции. В параметре %code% указан код выдачи, %status% - устанавливаемый статус,%kurier% - код курьера, %date% - дата выдачи, %address% - код адреса

'''OnBeforeClientSave''' - событие срабатывает перед сохранением изменений в карточке клиента. Код выполняется не в транзакции и есть возможность показывать диалоговые окна. В качестве параметров переданы %code% (содержит код клиента) и объект fieldlist (полный аналог addressrecord в доп. услугах), который содержит ещё не сохранённую информацию о карточке клиента, а так же все её пользовательские поля. Если результат функции -1, то происходит отмена сохранения без ошибки (abort).

'''OnAfterClientSave''' - событие срабатывает после сохранения изменений в карточке клиента. Код выполняется в транзакции. В качестве параметров переданы %code% (содержит код клиента) и объект fieldlist (полный аналог addressrecord в доп. услугах), который содержит сохранённую информацию о карточке клиента, а так же все её пользовательские поля с предыдущими значениями, которые можно получить через функцию _Former('VarCode', значение, 'VarValue')

'''OnBeforeBasePutCheck''' - событие срабатывает при проставлении галки на вкладке срочных заказов. Код выполняется не в транзакции и есть возможность показывать диалоговые окна. В параметре <nowiki>%code%</nowiki> указан код срочного заказа, а в параметре <nowiki>%BasePutCheckType%</nowiki> указан тип проставления: 0 - если галка, 1 - если плюс. Если результат функции -1, то отмена выполняемой функции (abort).

'''OnAfterCreateSpecialSMA''' - событие срабатывает после создания нового АПД для клиента. Код выполняется вне транзакции, потому есть возможность показывать диалоговые окна. В качестве единственного параметра %code% передается код созданного АПД.

'''OnBeforeReturnIncome''' - Событие перед приемом возврата на вкладке выдача. Код выполняется вне транзакции. Содержит %Code% - код адреса. Функция заполняет две переменные: ''$mass'' - масса возврата корреспонденции (проставляется только если значение переменной больше нуля, а если это значение больше массы корреспонденции, то будет использовано в качестве массы места) и ''$kurier'' - код вернувшего курьера (если пустое или равно нулю, то проставляется стандартный код курьера ВОЗВРАТ НА СКЛАД [15]).

'''OnBeforeCreatePickup''' - Событие перед созданием забора правой кнопкой мыши в списке заказов. Код выполняется вне транзакции. Содержит %Code% - код заказа. %FromCompany% - компания, у которой осуществляется забор (поле target), %FromAddress% - адрес забора

'''AfterTicketAnswer''' - Событие происходит после ответа на тикет. %code% - код сообщения, %TimeSpent% - кол-во потраченных минут, %ticket% - номер тикета. Доп. возможность может отключить стандартный ввод затраченного времени, для этого нужно вернуть любое значение.

'''OnAfterTownSave''' - событие срабатывает после заведения нового населенного пункта через интерфейс справочника городов. Параметры: %code% - код населенного пункта, %name% - название населенного пункта, %city% - код региона (области).

'''OnSetAddressState''' - событие срабатывает при изменении пользовательского статуса в карточке корреспонденции. Параметры: %State1% - текущий выбранный статус, %OldState1% - предыдущий выбранный статус, так же в доп. возможности доступен объект FieldList на корреспонденцию.

'''OnBeforeManifestSave''' - событие, срабатывает перед сохранением в карточке манифеста, выполняется перед транзакцией потому можно показывать диалоговые окна. Параметры: %Code% - код манифеста, %StoreFromCode% - филиал-отправитель, %StoreCode% - филиал получатель, %SentDate% - дата отправки.

'''OnAfterManifestSave''' - событие, срабатывает после сохранения в карточке манифеста, выполняется в транзакции потому показывать диалоговые окна нельзя. Параметры: %Code% - код манифеста, %StoreFromCode% - филиал-отправитель, %StoreCode% - филиал получатель, %SentDate% - дата отправки.

== Настройка документов ==
'''CustomAddressPrnForm2''' - Кастомная реализация упрощенной печатной формы. В карточке заказа установлена галка Простые, и установлена переменная "Справочники" -> "Переменные" -> "Печать" -> "Упрощенные печатные формы" -> "Тип упрощенной печатной формы: 5"

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

'''OnShelvingBarScan''' - Обработка отсканированного штрих-кода при комплектации.

'''AdditionalStringForSMA''' - задает дополнительные условия для формирования АПД (наиболее часто: разделения актов на нал. и безнал, помимо этого практически неограниченные возможности по изменению условий для отбора корреспонденций в акт, учета их доставленности и т.п.) Содержит %code% - код клиента, переменную %ActPayType% со значениями типов оплаты входящих в акт отправлений: "nal" - наличный, "bnal"- безналичный,"all" - все, а ткаже %ActDateTo% - с датой, до которой создается акт. Может возвращать строку, разделенную символами переноса строки. (На 17.09.2021 в возвращаемой строке предусмотрен 1 символ переноса, т.е. строка состоит из двух частей.) В этом случае часть строки до первого переноса будет использоваться в запросе как доп. условие отбора, часть строки после первого символа пеерноса - в качестве дополнительного условия для определения "выполненности" доставки (поле specialsma.Made). С помощью второго модификатора можно сделать например так, чтобы корреспонденции с незаполненными датой/временем вручения считались доставленными.

'''CustomBillDetaling''' - Кастомная детализация счета. Установка переменной $CancelCustomDetail в true, включает вывод стандартной детализации. В переменной $schet - код счета по которому строится детализация.

'''OnSchetChanged''' - Выполняется при удалении счета и его изменении. Содержит %code% - код счета schet.code

'''GetSchetNumber''' - Выполняется при расчете номера счета\фактуры. Возвращаемое значение (не null) будет номером счета. Содержит %code% - наименование поля FactNumber или Number. Объект fieldlist - все поля таблицы schet. Например, fieldlist.code - код счета, fieldlist.date - дата счета, и т.д.

'''QRCodePurpose''' - задает строку "Назначение платежа" (тэг "Purpose") в платежном QR-коде счета. По умолчанию "Курьерские услуги". Содержит %code% - код счета schet.code, %Source% - код клиента clients.code

'''ExceptionsForAPK''' - Задает дополнительные критерии поиска корреспонденции при формировании акта передачи корреспонденции(АПК). Содержит %Boxes% - псевдоним таблицы вложений используемый в запросе. Функция возвращает !ДВЕ! части sql запроса разделенных CRLF. При отборе в АПК используется два запроса. Первый - отбирает не доставленные заказы и возвраты документов, в него будет подставлено условие слева от разделителя CRLF. Второй запрос отбирает возращенные товары, в него будет подставлено условие справа от разделителя CRLF или вся строка условий если в строке нет разделителя CRLF (оставлено для обратной совместимости, в версии программы до 1115 фильтрация была только во втором запросе). %AdditionalParam% - дополнительный параметр, который можно установить в интерпретаторе при вызове функции CreateAddressTransferAct.
пример кода по умолчанию, фильтр только по второму запросу, вложение с названием "Доставка" - не попадает в АПК
<NOWIKI><?>
SET($ExcStr,' and %Boxes%.Name not like ''%Доставка%'' ');
$ExcStr</NOWIKI>

пример для изменения фильтрации сразу у двух запросов:
<NOWIKI><?>
SET($WHERE1,''); rem('условие отбора не доставленных и возврата документов');
SET($WHERE2, ''); rem('условие отбора возврата товаров');
$WHERE1 + CHAR(13) + CHAR(10) + $WHERE2</NOWIKI>

'''OnOrderCountCalc''' -Для расчета стоимости доставки необходимо учитывать кол-во отправлений. Доп. возможность возвращает часть SQL запроса, уточняющий условия поиска. Содержит %code% - равен значению переменной "Считать кол-во отправлений по текущему месяцу" (UseCurrentMonthCount, нет - 0, да - 1)

'''OnGetZakazCount''' - подменяет стандартный подсчет количества отправлений для расчета стоимости доставки (в том чисте отменяется вызов доп.возможности OnOrderCountCalc). Должна возвращать кол-во корреспонденций. В процедуру передаются следующие переменные: %CntAccType% - вид подсчета: 0-по заказу, 1-за месяц по клиенту; %code% - код клиента (обязателен для вида подсчета 1); %ZakazDate% - дата заказа; %CountByMonthType% - способ подсчета заказов за месяц (1-по текущему месяцу; 0 - по предыдущему); %UseCurrentUrgency% - 1:подсчитывать только корреспонденцию определенного режима срочности; %Mode% - этот режим срочности (при подсчете по заказу учитываются так же связанные режимы срочности, указанные в параметре 5 режима срочности в таблице статусов); %DatePut% - дата доставки (добавлено для альтернативных видов подсчета, может быть null); %SeparateIntercityDelivery% - 1:не учитывать междугородние доставки; В функцию так же передается объект fieldlist.

'''OnSMABarcodeScan''' - событие вызывается при сканировании штрихкода АПК в списке актов. %code% - код АПК (sendmoneyact.code)

'''OnPaintSMAColumns''' - вызывается при прорисовке таблицы в форме списка АПД/АПК. В функцию передается DataSet, содержащий поля таблиц SendMoneyAct и Clients, а так же пользовательские поля клиентов, называющиеся ufX, где X - номер поля (в статусах). Функция должна возвращать строку следующей структуры:
Поле1_таблицы, Цвет_фона, Поле2_таблицы, Цвет_фона и т.п. Возврат нечетного числа параметров эквивалентен возврату пустой строки (цвет не меняется)

'''CustomZPDetail''' - кастомное дополнение к детализации зарплаты (Специальная надбавка). Вызывается из скриптовой детализации зарплаты. Предназначено для расчета и вывода в детализацию значения какой-либо специальной надбавки, определенной пользователем. Входящие параметры: %code% - код платежа в таблице kurier_pays, %kurier% - код курьера. Возвращает строку, где через запятую указаны Название надбавки и ее значение. Если эта строка не содержит двух параметров - ничего не выводится.

'''ZPAdditionalSheets''' - кастомное дополнение к детализации зарплаты - дополнительный лист(листы) на форме детализации. В функцию передается DataSet из детализации зарплаты, ссылка на объект Excel (имя - xl). Внутри функции нельзя объявлять объект TSelfAdo с именем DB (он объявлен в детализации). Номер новой страницы Excel передается в переменной $page.

'''OnAddrInventoryAfterCreateDoc''' - вызывается в транзакции, в процедуре создания документа инветаризации корреспонденции. Входящие параметры: %code% - код созданного документа инвентаризации.

'''AddrInventoryAdditionalSQL''' - позволяет модифицировать запрос на создаваемый документ инвентаризации корреспонденции. Используется для наложения дополнительных фильтров. Входящие параметры: %code% - код созданного документа инвентаризации. %header% - часть SQL запроса в которую необходимо сделать вставки, возможные варианты join, where.
Пример использования '''AddrInventoryAdditionalSQL''', добавление фильтра по пользовательскому полю.
<source lang="SQL">
<?>
if('%header%'='join', 'left join userfields uf on uf.sourcecode=b.source and uf.sourcetable=2 and uf.varvalue=1',
if('%header%'='where', 'and ifnull(uf.varvalue, "F") = "T"'
,''))
</source>
.

== Настройка вида маркера ==
Настройки находятся в "Отчеты" -> "Дополнительные возможности" - "Системные". 

В функции передается объект Table2Map типа [[Руководство программиста#Объект TFieldObject|TFieldObject]]. Получить поля с примерами значений из него можно например так:
showmessage(table2map._GETTABLEINFO)
(текст большое сообщения можно скопировать в буфер комбинацией Ctrl-C).

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

Так же текущее состояние окна карты доступно через переменные:

$PlanDate - Выбранная дата, на которую планируется.

$KurierCode - Код выделенного курьера.

$MetroCode - Код выделенной станции метро (маршрута).

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

set($s, try(
error('вот тут ошибка, которую вы увидите в виде сообщения');
));
if($s, showmessage($s), '');

'''MapObjectFigure''' - Доп. возможность позволяет установить вид маркера на карте. Результат определяет фигуру: 1 - перевернутый треугольник (острым концом вниз), 2 - треугольник, 3 - увеличенный перевернутый треугольник (острым концом вниз), чтобы квадрат не мог его перекрыть, 4 - квадрат, 5 - ромб, все остальное круг. Ромб поддерживается с версии 960. 
Например:
if(table2map.zabor, 2, if(StrDateToFloat(table2map.DatePeriod) = $PlanDate, 3, 4))
Выводит треугольник, если отправление - забор. Иначе - если дата план отправления равна дате, на которую планируется - увеличенный перевернутый треугольник, иначе - квадрат.

'''MapObjectColor''' - Доп. возможность позволяет установить цвет маркера на карте.
При помощи данных параметров можно создать условия отображения маркеров. 

Для доступа к настройкам доступны переменные:

$Color

$DefaultColor

$PlanedColor

$SelectedPlanedColor

$GetKurierColor

Например:
if((table2map.kurier<20)*(StrDateToFloat(table2map.DatePeriod) = $PlanDate), 16753920, $color)
Не запланированные отправления на текущий день будут отображаться выбранным цветом, иначе - цветом по-умолчанию.

== Речь диктора ==

'''OnGivnVoice''' - выполняется после изменения статуса выдачи. Параметр <nowiki>%code%</nowiki> содержит код выдачи, <nowiki>%State%</nowiki> содержит код устанавливаемого статуса, <nowiki>%OldState%</nowiki> - код старого статуса (0 если не было). Позволяет отключать стандартный звук ОК, если возвращает не 0.

'''OnDashboardManifestVoice''' - выполняется после сканирования адреса в интерфейсе приёма манифестов. Параметр <nowiki>%code%</nowiki> содержит код корреспонденции. Позволяет отключать стандартную диктовку программой (код курьера, вес и т.д.), если возвращает не 0.

== Настройка мобильного приложения ==

== Скрипты ==
'''OnEveryStartApp''' - выполняется при запуске программы.

'''OnEveryCloseApp''' - выполняет при закрытии программы.

'''OnBarScan''' - выполняется при получении ШК со сканера, в параметре %code% - получаем ШК. Если функция, что-то возвращает, то система будет использовать возвращенный ШК.

'''OnMapBeforeGeolocation''' - Вызывается перед отображаем адреса на карте. В функцию передается объект fieldlist.
Пример скрипта, переводящий адреса в НЕ найденные на карте, если станция метро НЕОПЕРЕДЕЛЕННАЯ.
<NOWIKI><?>
if(station=0,
_set('lon', null);
_set('lat', null);
_set('searchCoordinate', 'F');
,0)</NOWIKI>

'''OnSyncInsert''' - Выполняется для каждой добавленной записи при синхронизации с ЛК. Содержит %tablename% - название синхронизируемой таблицы.

'''OnSyncUpdate''' - Выполняется для каждой обновленной записи при синхронизации с ЛК. Содержит %tablename% - название синхронизируемой таблицы.

Если при получении новых адресов с ЛК, нужно поменять любое поле в таблице address, то необходимо использовать сразу два события OnSyncInsert и OnSyncUpdate. Адреса без вложений обрабатываются событием OnSyncInsert, адреса с вложениями будут обрабатываться событием OnSyncUpdate. Это связано с механизмом синхронизации, если в событии OnSyncInsert, проапдейтить поле в адресе с вложениями, то данные могут потеряться.
Когда адрес без вложений, то у него сразу station = 65535 и можно апдейтить. Если с вложениями, то у него сначала station = 65534, а после синхронизации вложений есть отдельный апдейт на 65535. Пример кода, для апдейта поля в адресах, события OnSyncInsert и OnSyncUpdate:
<NOWIKI>

<?>
rem(ticket 23584, 23583);
if( ('%tablename%'='address'),
query('UPDATE address a
JOIN trace t ON t.address=a.code AND t.state=1
JOIN zakaz z ON z.code=a.zakaz
SET
a.mode = IF(z.source=646, 3, 2)
WHERE
a.code = %code%
AND a.station=65535
AND (
(z.source=646 AND a.mode<>3) OR
(A.DATE_PUTN=DATE(t.Statetime) AND a.mode=1) OR
(A.DATE_PUTN=DATE_ADD(DATE(t.Statetime), INTERVAL 1 DAY) AND TIME(t.Statetime) > "21:59:59" AND a.mode=1)
)')
, '');</NOWIKI>
;

'''OnCalcSalary''' - Событие происходит после начисления зарплаты курьеру. %code% - код созданного начисления kurier_pays.code ; %dateto% - дата до которой рассчитали зарплату; И отдельно части зарплаты: %profit% -итоговая сумма; %Zarab% - сдельная часть; %Oklad% - оклад; %Friends% - выплаты за приведенных; %Other% - разное; %AgentMoney% - агентское вознаграждение; %StandingMoney% - Доплата за стаж; %Bonus%, %Shtraf% - бонусы и штрафы.

'''OnCalcAvans''' - Событие происходит после начисления аванса курьеру. %code% - код созданного начисления kurier_pays.code. Можно произвести дополнительные начисления и удержания из kurier_pays.profit.

'''OnTicketSetCusr''' - Пользовательский скрипт перед назначением ответственного в тикетах. %code% - код тикета; %Cusr% - код назначаемого пользователя (может быть равно NULL)

'''OnCreateAddressForActDelivery''' - Пользовательский скрипт вызывающийся в момент формирования корреспонденции на доставку АПД/АПК. Позволяет существенно доработать формируемую корреспонденцию. %code% - код акта sendmoneyact.code, %Client% - код клиента; %delivery% - флаг определяющий корр. на доставку акта (1, значение по умолчанию) или забор акта. fieldlist - объект с полями адреса (повторяет структуру таблицы address), dataset - объект дополнительными полями функции. Объект fieldlist является классом TMyFieldList и позволяет менять значения полей. Также измененный адрес можно сохранить прямо в событии, или он будет сохранен автоматически после выполнения скрипта. Для сохранения адреса используйте метод _save.

Пример, для клиента с кодом 3360, в корреспонденцию на доставку АПК, добавляем список корреспонденций попавших в него во вложения.
<source lang="sql">
<?>
if((client=3360)*(ActType=2),
rem('Ticket 70827, 2022-09-07 Anatoly and Sergey');
set($addresscode, fieldlist._save);
query('insert boxes (address, pos, name)
select '+$addresscode+' AS address, @q := @q + 1 AS pos,
CASE WHEN a.client_id <> '' THEN a.client_id WHEN a.strbarcode<>'' THEN a.strbarcode ELSE CONCAT(a.zakaz,"-", a.number) END AS `name`
FROM addressfld af
JOIN address a ON a.code=af.`address` ,(SELECT @q := 0 ) p
WHERE
af.`AddrTransferCode` = %code% AND af.`ReceivedInTransfer` > 0');
,0);
</source>

'''OnAfterPreassemblyScan''' - событие происходит после сканирования складского товара в корреспонденцию на вкладке «Склад». %code% - код корреспонденции, %ItemCode% - код товара, %ItemCnt% - количество отсканированного товара.

'''OnGeocodeScript''' - скрипт подключения к геокодеру клиента. Используется при включенной переменной "Справочники" -> "Переменные" -> "Подключения" -> "Карты" -> "Геокодирование" -> "Протокол геокодирования: Клиентский (скрипт OnGeocodeScript)". Имеет встроенные переменные:
*$address - адрес для геокодирования;
*$town - код города;
*$street и $home - упрощенный адрес;

Скрипт должен вернуть следующие переменные :
*$lon и $lat - координаты ;
*$goodaddress - нормализованный адрес (не обязательно);

<source lang="sql">
<?>
set($response, HTTPPOST('http://XXXXXXXX',
'{"query":'+ FormatTextJSON($address)+ '}',
'','','','',
'post', 'application/json', 10000));

if($response!'',
new('TJSON', 'json');
set($e, try(
json.SetText($response);
json.OpenChild('geo_data');
json.OpenChild('mid');
set($lat, sqlfloat(json.ChildNodeValue('lat')));
set($lon, sqlfloat(json.ChildNodeValue('lon')));
));
if($e, error('Ошибка в разборе ответа: '+$e), '');
, error('Пришел пустой ответ от геокодера')
);
</source>

'''OnFilterAddressRecalc''' - Позволяет отфильтровать коды адресов, для которых можно пересчитать стоимость. Событие происходит перед расчетом стоимости доставки из интерфейса программы для: актов, счетов, заказов, и т.д. Не работает для пересчета запускаемого из самой карточки корреспонденции.
%codes% - коды адресов для пересчета стоимости доставки. Формат: (1,2,3,...). %RecalcUserCode% - код пользователя запустившего пересчет (актуально для отложенных пересчетов).
Функция должна вернуть коды адресов, допущенных к пересчету в формате: (1,2,3,...)

<source lang="sql">
<?>
rem('2023-12-04 Sergey. Отключаем перерасчет стоимости доставки у корреспонденций в статусе - проверено,
если у пользователя нет права Счета-изменять. Тикет 79954.
Блокировка работает в связке с тикетом 77995.');
new('TSelfADO', 'DB');
DB.OPEN('SELECT a.code FROM courier.address a
LEFT JOIN courier.users u ON u.code=%RecalcUserCode%
LEFT JOIN courier.`userrules` ur ON ur.`GroupId`=u.grup AND ur.`RuleType`=1 AND ur.newruleid =78 -- RSA
WHERE ((a.state1<>8) OR (a.state1=8 AND ur.state="T")) AND a.code in %code%');
DB.ParseForIn('CODE')
</source>

'''OnRecalcBoldCntInFrame''' - срабатывает в карточке тарифа при перемещении курсора зоны. Возвращает целочисленное значение, равное количеству доставленных корреспонденций у клиента за предыдущий месяц. Срабатывает только при открытии карточки тарифа из карточки клиента. %ClientCode% - код клиента. %ZoneCode% - код зоны.

'''ChangeStatusColor''' - подменяет цвет фона сообщения в строке статуса в форме приема корреспонденции. Возвращает целочисленное значение - новый цвет фона, 0 - если цвет менять не нужно. Входящие значения: %code% - входящее значение цвета. Остальные переменные - булевского типа - отражают состояние Настроек: %Renum% - Перенумеровывать, %IgnoreDblScan% - Игнорировать ошибки повторного сканирования, %PrintNakl% - Печатать накладные, %Given% - Выдавать отправления, %PrintFiles% - Печатать файлы, %BarLine% - Включить поддержку штрих-кодовой линейки, '%CreateTrans% - формировать кассовые чеки.

'''GetLusrSQL''' - переопределяет столбец "Изменивший пользователь" в истории изменений. Должен возвращать часть SQL запроса для столбца lusr. Входящее значение %code% содержит код таблицы, для которой строится SQL-запрос истории.

'''OnBeforeSendSMS''' - выполняется перед рассылкой шаблона СМС. Содержит в себе %MessageText% - текст сообщения отправляемого по шаблону, %Phone% - номер телефона. Если возвращает значение -1, отправка стандартными средствами не происходит.

'''TariffCalculatorTotal''' - функция для настройки простой формы тарификатора. Работает в двух режимах: sql - запрос для построения грида. В режиме доступны теги: %ClientCode%' - код клиента, '%PriceCode%' - код прайса клиента. Столбцы SQL запроса строго фиксированы: code - код поля, fieldname - название поля, costparams - варианты цен через запятую (для отображения комбобокса), modlist - список названий для разных цен через запятую, modvalue - выбраный элемент. Второй режим это формула расчета строки, в этом режиме доступен dataset со всеми ранее рассчитанными строками и теги '%FieldCode%', '%Cost%', '%Quantity%', '%ClientCode%', '%PriceCode%', '%DefaultTotal%'.

<source lang="sql">
<?>
<?>
if('%code%'='sql',
'(SELECT s.statecode AS code, -- код поля
s.name AS fieldname, -- название поля
IFNULL(uf.varvalue, "") AS costparams, -- варианты цен через запятую (для отображения комбобокса)
IFNULL(unquotedstr(getparam(s2.advansed, 3)), "") AS modlist, -- список названий для разных цен через запятую
IFNULL(mods.`varValue`, '''') AS modvalue -- выбраный элемент
FROM states s
LEFT JOIN userfields uf ON uf.sourcetable=11 AND uf.sourcecode=%PriceCode% AND uf.varcode=s.statecode
LEFT JOIN userfields AS mods ON mods.`sourceCode`=%ClientCode%
AND mods.sourcetable=2 AND mods.varcode = CAST(uf.varcode AS SIGNED) - 20 AND mods.`varCode` IN (10,11)
LEFT JOIN states s2 ON s2.statetype=35 AND s2.`StateCode`=mods.`varCode`
WHERE s.statetype=45
AND IFNULL(s.hidden,"F")="F"
AND getparam(s.advansed, 1) <> "0"
ORDER BY s.statecode)
union (SELECT 1000,"ПОДДЕРЖКА", "1,2,3", "Поддержка 1, Поддержка 2, Поддержка 3","" )
'
,
if(%FieldCode%=1000,

case(
when(%Cost%=1,
100
);
when(%Cost%=2,
200
);
when(%Cost%=3,
300
);
)
,
%cost%*%Quantity%
)
)
</source>

Отладчик встроенных скриптов

2026-03-17T16:23:41Z

Sammy: /* Подпись скрипта */

= Интерфейс =

[[Файл:ScriptDebugger.png]]

'''Отладчик скриптов''' — рабочий инструмент для разработки и диагностики [[Руководство_программиста|скриптов встроенного языка]].
Он позволяет запускать скрипты в режиме отладки, останавливать выполнение на нужных строках, анализировать переменные и подключаться к уже запущенным скриптам.
Вы можете запустить отладчик из:
* Через меню '''Отчеты > SQL > Выполнить > Запустить отладчик'''.
* Через меню '''Отчеты > Дополнительные возможности > Редактировать'''.
* Горячей клавишей '''Ctrl+Alt+D''' в главном окне приложения.

= Основные возможности =

* '''Запуск в режиме отладки''' — выполнение скрипта с остановкой на заданных строках
* '''Просмотр переменных''' — автоматическое отображение значений всех переменных при остановке
* '''Наблюдение за выражениями''' — вычисление произвольных выражений при каждой остановке
* '''Точки останова''' — остановка выполнения на выбранных строках кода
* '''Подключение к скриптам''' — подключение к скрипту запущенному без отладчика
* '''Работа с файлами''' — открытие, сохранение и отслеживание изменений файлов скриптов
* '''Расширенный редактор''' - подсветка парных скобок, отображение скрытых симолов, закладки.

= Интерфейс отладчика =

== Редактор кода ==

Основная область для написания и редактирования скрипта. Редактор поддерживает:
* Подсветку синтаксиса
* Нумерацию строк
* Визуальное отображение точек останова (красные кружки в левом поле)
* Подсветку текущей строки выполнения (желтый фон)
* Подсветку парных скобок
* Отображение скрытых символов
* Закладки для быстрой навигации
== Лог ==

Отображает:
* Вывод сообщений напрямую из скрипта командой '''print'''
* Сообщения отладчика (остановка на breakpoint, ошибки)

== Кнопки управления ==

* '''Запустить''' — Запуск скрипта в режиме отладки (F9). При необходимости установите точки останова, cкрипт выполнится до первой точки останова или до ошибки.
* '''Остановить''' — Прерывание дальнейшего исполнения скрипта. Во время выполнения скрипта можно нажать и удерживать клавишу '''ESC''' для аварийной остановки.
* '''Продолжить''' — Возобновление выполнения после остановки скрипта (F9)

= Работа с отладчиком =

== Установка точек останова ==
Точки останова можно настроить перед запуском скрипта или когда выполнение скрипта приостановлено. Добавление точки останова:

'''Способ 1.''' Щёлкните левой кнопкой мыши в левой части нужной строки (область номеров строк). На строке появится красный кружок — точка останова установлена. Повторный щелчок удалит её.

'''Способ 2.''' Установите курсор на строку и используйте пункт меню '''Скрипт''' > '''Добавить точку останова (F5)'''.

== Просмотр переменных ==

Список '''Переменные''' содержит все переменные и объекты доступные в текущем инстансе интерпретатора. Список автоматически отображаются в момент остановки выполнения скрипта.

== Наблюдение за выражениями ==
Список '''Наблюдения''' показывает все добавленные пользователям выражения и их рассчитанные значения. Значения обновляются автоматически в момент остановки выполнения скрипта или после редактирования выражения. Для добавления наблюдения:
# Выделите текст в редакторе (например, имя переменной или выражение)
# Выберите в контекстном меню редактора пункт '''Добавить в наблюдение'''
# Либо используйте меню '''Скрипт''' > '''Добавить наблюдение (Сtrl+F5)''' и введите выражение вручную.

'''Примеры выражений:'''
* $a + $b — сумма переменных
* db.RecordCount — количество записей в наборе данных
* $i > 0 — логическое условие

= Работа с файлами =

== Открытие файла с отслеживанием ==

Меню '''Файл''' > '''Открыть и отслеживать'''.

Открывает файл скрипта и включает автоматическое отслеживание изменений на диске.
При изменении файла во внешнем редакторе текст автоматически обновляется в отладчике.

== Сохранение в файл ==

Всегда есть возможность сохранить скрипт в файл.
* Меню '''Файл''' > '''Сохранить в файл''' — Сохраняет текущий текст скрипта в файл. Если файл был сохранен ранее, по умолчанию предлагается предыдуший путь.

* Меню '''Файл''' > '''Сохранить (Ctrl+S)''' — Когда отладчик открыт без привязки к конкретному скрипту, то сохраняет изменения в файл.
'''Важно!''' Если отладчик открыли например из '''Отчеты''' > '''Дополнительные возможности''' > '''Редактировать''' то сохранения через пункт '''Сохранить (Ctrl+S)''' сохранения '''всегда''' будет происходить в базу, в файл изменения сохранены не будут.

= Сохранение =

Если отладчик открыт как редактор скрипта, доступны функции по сохранению напрямую в базу данных:
* Меню '''Файл''' > '''Сохранить (Ctrl+S)''' — сохранить скрипт в базу данных
* Кнопка '''Сохранить и закрыть''' — сохранить скрипт и закрыть окно отладчика

= Подключение отладчика к работающим скриптам =
Данная возможность позволяет подключить отладчик к скриптам изначально запущеным без него. Для начала работ, отладчик нужно перевести в режим '''ожидания запросов отладки'''. Далее необходимо запустить скрипт стандартным способом. Если в скрипте будет команда AttachDebugger - отладчик это увидит и начнется процесс отладки этого скрипта. Это удобно для отладки скриптов, которые работают в своем контексте:
* [[Печатные формы|Скриптов из печатных форм]]
* [[Дополнительные_возможности|Скриптов из системных событий]]
* [[Пользовательские_отчеты|Скриптов дополнительных возможностей]]
* [[Дополнительные услуги|Скриптов из дополнительных услуг]]

'''Как использовать'''

#'''В отладчике:'''
## Откройте отладчик скриптов, главное меню '''Отчеты''' > '''SQL''' > '''Выполнить''' > '''Запустить отладчик (F9)'''.
## Включите режим отслеживания: меню '''Файл''' > '''Ожидать команды AttachDebugger'''.
## В строке состояния отладчика появится сообщение '''Ожидание команды AttachDebugger...'''.
## Свернуть отладчик, если его закрыть то наблюдение остановится.
#'''В скрипте:'''
## Скрипт нужно подготовить. В скрипте нужно прописать команду '''AttachDebugger''' она должна быть '''первой командой''' или идти следующей строкой после тега начала скрипта '''<?>'''
## Запустить скрипт стандартным образом: Сформировать печатную форму, рассчитать стоимость доставки, выполнить действие для вызова события.
#'''Что происходит:'''
## При выполнении команды AttachDebugger - скрипт останавливается.
## Отладчик автоматически подключается к перехваченному скрипту.
## Текст скрипта загружается в редактор отладчика.
## Можно ставить точки останова, просматривать переменные и продолжать отладку.

Пример скрипта с запросом подключения к отладчику:
<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Команда `AttachDebugger` должна быть первой командой в скрипте.
* Если режим отслеживания не включён, команда AttachDebugger в скрипте игнорируется и ничего не делает.
* В режиме отслеживания может работать только один отладчик.
* Если скрипт исполняется в шедулере или в другом вспомогательном потоке, то подключится к нему не получится. Отладка работает только в текущем потоке приложения.

== Подпись скрипта ==
При одновременной работе нескольких программистов в отладчике возможны ложные перехваты. Чтобы сфокусировать работу отладчика только на определенном скрипте, подпишите его:
AttachDebugger('ЛЮБОЙ ТЕКСТ');

Отладка начнется, только если в редакторе кода строка AttachDebugger совпадает с перехваченным скриптом.

Пример скрипта с подписью:
<source lang="json">
<?>
AttachDebugger('Sergey K. TestScript');
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

= Горячие клавиши =

{| class="wikitable"
|-
! Клавиша !! Действие
|-
| '''F9''' || Запустить скрипт в режиме отладки или продолжить исполнение
|-
| '''ESC''' || Аварийная остановка скрипта (удерживать)
|-
| '''F5''' || Добавить или удалить точку останова
|-
| '''Ctrl+F5''' || Добавить наблюдение
|-
| '''Ctrl+S''' || Сохранение изменений в базу данных, если скрипт был открыт для редактирования в отладчике
|-
| '''Ctrl+1..9''' || Перейти в закладку 1 .. 9 в редакторе кода
|-
| '''Ctrl+Shift+1..9''' || Добавить закладку 1 .. 9 в редакторе кода
|-
| '''Ctrl+Shift+U''' || Двигать выбранный блок влево
|-
| '''Ctrl+Shift+I''' || Двигать выбранный блок вправо
|}

= Настройки редактора =

== Перенос строк ==

Контекстное меню редактора > '''Перенос строк'''.

Включает или выключает автоматический перенос длинных строк.
Настройка сохраняется и восстанавливается при следующем запуске отладчика.

== Отображение специальных символов ==

Контекстное меню редактора > '''Показать специальные символы'''.

Показывает пробелы и табуляции в виде специальных символов.
Удобно для поиска лишних пробелов и контроля форматирования кода.

= Примеры использования =

== Пример 1: Отладка скрипта с точками останова ==

'''Задача.''' Проверить корректность простого цикла суммирования. Пример скрипта:
<source lang="json">
<?>
set($i, 10);
set($sum, 0);
while($i > 0,
set($sum, $sum + $i);
set($i, $i - 1)
);
showmessage($sum);
</source>

План действий:
# Откройте отладчик, главное меню '''Отчеты''' > '''SQL''' > '''Выполнить''' > '''Запустить отладчик (F9)'''.
# Введите скрипт
# Установите точку останова на строке set($sum, $sum + $i);.
# '''Запустите скрипт (F9)'''.
# При остановке просмотрите значения $i и $sum в списке переменных.
# Добавьте выражение наблюдения $sum + $i.
# Нажимайте '''Продолжить''', наблюдая, как меняются значения до завершения цикла.

'''Что даёт отладчик:'''
* Видно, как накапливается сумма на каждом шаге.
* Можно быстро обнаружить ошибки в логике цикла.

== Пример 2: Отладка скрипта с условиями ==

'''Задача.''' Проверить, корректно ли выбирается максимум из двух значений. Пример скрипта:
<source lang="json">
<?>
set($a, 10);
set($b, 20);
if($a > $b,
set($result, $a),
set($result, $b)
);
showmessage($result);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке if($a > $b.
# Запустите скрипт (F9).
# При остановке просмотрите значения $a и $b.
# Добавьте выражение наблюдения $a > $b.
# Продолжите выполнение и посмотрите, какое значение попало в $result.

'''Что даёт отладчик:'''
* Понятно, при каких значениях срабатывает та или иная ветка условия.
* Удобно тестировать разные комбинации входных данных.

== Пример 3: Отладка работы с базой данных ==

'''Задача.''' Проверить правильность выборки и обработки данных из базы. Пример скрипта:
<source lang="json">
<?>
new('TSelfADO', 'db');
db.Open('SELECT code FROM city WHERE name Like "%Москва%"');
if(db.RecordCount > 0,
set($code, int(db.FieldByName('code'))),
0
);
showmessage($code);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке if(db.RecordCount > 0.
# Запустите скрипт (F9).
# При остановке просмотрите значение db.RecordCount.
# Добавьте выражение наблюдения db.FieldByName('code').
# Продолжите выполнение и убедитесь, что в $code попало ожидаемое значение.

'''Что даёт отладчик:'''
* Видно, сколько записей вернул запрос.
* Можно проверить конкретные значения полей перед дальнейшей обработкой.

== Пример 4: Отладка скрипта через AttachDebugger ==

'''Задача.''' Подключиться к скрипту запущенному без отладчика.
Пример скрипта:
<source lang="json">
<?>
AttachDebugger;
new('TSelfADO', 'db');
db.Open('SELECT COUNT(*) as cnt FROM address WHERE date_put IS NULL');
set($count, int(db.FieldByName('cnt')));
if($count > 100,
showmessage('Внимание! Много недоставленных адресов!'),
0
);
</source>

План действий:
# Откройте отладчик скриптов.
# Включите режим отслеживания меню '''Файл''' > '''Ожидать команды AttachDebugger'''.
# Откройте '''Отчеты''' > '''SQL''' введите скрипт из примера.
# Запустите скрипт через меню '''Выполнить''' > '''Выполнить как скрипт (F7)'''.
# Когда выполнение дойдёт до AttachDebugger, отладчик автоматически подключится.
# Установите точку останова на строке if($count > 100.
# Продолжите выполнение и проанализируйте значение $count.

'''Что даёт отладчик:'''
* Можно разбирать сценарии, которые запускаются не из отладчика, а из печтаных форм, дополнительных услуг и т.д.
* Скрипт становится доступен для анализа так же, как и обычный скрипт, запущенный из отладчика.

== Пример 5: Отладка скрипта с циклом FOR ==

'''Задача.''' Проверить корректность вычислений в цикле FOR. Пример скрипта:
<source lang="json">
<?>
set($sum, 0);
for($i, 1, 10,
set($sum, $sum + $i)
);
showmessage($sum);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке set($sum, $sum + $i);.
# Запустите скрипт (F9) и просматривайте значения $i и $sum при остановках.
# Добавьте выражение наблюдения $sum + $i для контроля вычислений.

'''Что даёт отладчик:'''
* Пошагово видно, как формируется итоговая сумма.
* Удобно находить ошибки в граничных условиях цикла.

== Пример 6: Использование выражений наблюдения ==

'''Задача.''' Одновременно контролировать несколько взаимосвязанных значений. Пример скрипта:
<source lang="json">
<?>
set($a, 10);
set($b, 20);
set($c, 30);
set($result, $a + $b + $c);
showmessage($result);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке set($result, $a + $b + $c);.
# Запустите скрипт (F9).
# Добавьте выражения наблюдения:
#* $a + $b
#* $b + $c
#* $a + $b + $c
# При остановке сравните значения выражений и итоговый результат.

'''Что даёт отладчик:'''
* Одновременно видно несколько ключевых показателей.
* Легче находить расхождения между промежуточными и итоговыми значениями.

Отладчик встроенных скриптов

2026-03-17T16:18:02Z

Sammy: /* Подключение отладчика к работающим скриптам */

= Интерфейс =

[[Файл:ScriptDebugger.png]]

'''Отладчик скриптов''' — рабочий инструмент для разработки и диагностики [[Руководство_программиста|скриптов встроенного языка]].
Он позволяет запускать скрипты в режиме отладки, останавливать выполнение на нужных строках, анализировать переменные и подключаться к уже запущенным скриптам.
Вы можете запустить отладчик из:
* Через меню '''Отчеты > SQL > Выполнить > Запустить отладчик'''.
* Через меню '''Отчеты > Дополнительные возможности > Редактировать'''.
* Горячей клавишей '''Ctrl+Alt+D''' в главном окне приложения.

= Основные возможности =

* '''Запуск в режиме отладки''' — выполнение скрипта с остановкой на заданных строках
* '''Просмотр переменных''' — автоматическое отображение значений всех переменных при остановке
* '''Наблюдение за выражениями''' — вычисление произвольных выражений при каждой остановке
* '''Точки останова''' — остановка выполнения на выбранных строках кода
* '''Подключение к скриптам''' — подключение к скрипту запущенному без отладчика
* '''Работа с файлами''' — открытие, сохранение и отслеживание изменений файлов скриптов
* '''Расширенный редактор''' - подсветка парных скобок, отображение скрытых симолов, закладки.

= Интерфейс отладчика =

== Редактор кода ==

Основная область для написания и редактирования скрипта. Редактор поддерживает:
* Подсветку синтаксиса
* Нумерацию строк
* Визуальное отображение точек останова (красные кружки в левом поле)
* Подсветку текущей строки выполнения (желтый фон)
* Подсветку парных скобок
* Отображение скрытых символов
* Закладки для быстрой навигации
== Лог ==

Отображает:
* Вывод сообщений напрямую из скрипта командой '''print'''
* Сообщения отладчика (остановка на breakpoint, ошибки)

== Кнопки управления ==

* '''Запустить''' — Запуск скрипта в режиме отладки (F9). При необходимости установите точки останова, cкрипт выполнится до первой точки останова или до ошибки.
* '''Остановить''' — Прерывание дальнейшего исполнения скрипта. Во время выполнения скрипта можно нажать и удерживать клавишу '''ESC''' для аварийной остановки.
* '''Продолжить''' — Возобновление выполнения после остановки скрипта (F9)

= Работа с отладчиком =

== Установка точек останова ==
Точки останова можно настроить перед запуском скрипта или когда выполнение скрипта приостановлено. Добавление точки останова:

'''Способ 1.''' Щёлкните левой кнопкой мыши в левой части нужной строки (область номеров строк). На строке появится красный кружок — точка останова установлена. Повторный щелчок удалит её.

'''Способ 2.''' Установите курсор на строку и используйте пункт меню '''Скрипт''' > '''Добавить точку останова (F5)'''.

== Просмотр переменных ==

Список '''Переменные''' содержит все переменные и объекты доступные в текущем инстансе интерпретатора. Список автоматически отображаются в момент остановки выполнения скрипта.

== Наблюдение за выражениями ==
Список '''Наблюдения''' показывает все добавленные пользователям выражения и их рассчитанные значения. Значения обновляются автоматически в момент остановки выполнения скрипта или после редактирования выражения. Для добавления наблюдения:
# Выделите текст в редакторе (например, имя переменной или выражение)
# Выберите в контекстном меню редактора пункт '''Добавить в наблюдение'''
# Либо используйте меню '''Скрипт''' > '''Добавить наблюдение (Сtrl+F5)''' и введите выражение вручную.

'''Примеры выражений:'''
* $a + $b — сумма переменных
* db.RecordCount — количество записей в наборе данных
* $i > 0 — логическое условие

= Работа с файлами =

== Открытие файла с отслеживанием ==

Меню '''Файл''' > '''Открыть и отслеживать'''.

Открывает файл скрипта и включает автоматическое отслеживание изменений на диске.
При изменении файла во внешнем редакторе текст автоматически обновляется в отладчике.

== Сохранение в файл ==

Всегда есть возможность сохранить скрипт в файл.
* Меню '''Файл''' > '''Сохранить в файл''' — Сохраняет текущий текст скрипта в файл. Если файл был сохранен ранее, по умолчанию предлагается предыдуший путь.

* Меню '''Файл''' > '''Сохранить (Ctrl+S)''' — Когда отладчик открыт без привязки к конкретному скрипту, то сохраняет изменения в файл.
'''Важно!''' Если отладчик открыли например из '''Отчеты''' > '''Дополнительные возможности''' > '''Редактировать''' то сохранения через пункт '''Сохранить (Ctrl+S)''' сохранения '''всегда''' будет происходить в базу, в файл изменения сохранены не будут.

= Сохранение =

Если отладчик открыт как редактор скрипта, доступны функции по сохранению напрямую в базу данных:
* Меню '''Файл''' > '''Сохранить (Ctrl+S)''' — сохранить скрипт в базу данных
* Кнопка '''Сохранить и закрыть''' — сохранить скрипт и закрыть окно отладчика

= Подключение отладчика к работающим скриптам =
Данная возможность позволяет подключить отладчик к скриптам изначально запущеным без него. Для начала работ, отладчик нужно перевести в режим '''ожидания запросов отладки'''. Далее необходимо запустить скрипт стандартным способом. Если в скрипте будет команда AttachDebugger - отладчик это увидит и начнется процесс отладки этого скрипта. Это удобно для отладки скриптов, которые работают в своем контексте:
* [[Печатные формы|Скриптов из печатных форм]]
* [[Дополнительные_возможности|Скриптов из системных событий]]
* [[Пользовательские_отчеты|Скриптов дополнительных возможностей]]
* [[Дополнительные услуги|Скриптов из дополнительных услуг]]

'''Как использовать'''

#'''В отладчике:'''
## Откройте отладчик скриптов, главное меню '''Отчеты''' > '''SQL''' > '''Выполнить''' > '''Запустить отладчик (F9)'''.
## Включите режим отслеживания: меню '''Файл''' > '''Ожидать команды AttachDebugger'''.
## В строке состояния отладчика появится сообщение '''Ожидание команды AttachDebugger...'''.
## Свернуть отладчик, если его закрыть то наблюдение остановится.
#'''В скрипте:'''
## Скрипт нужно подготовить. В скрипте нужно прописать команду '''AttachDebugger''' она должна быть '''первой командой''' или идти следующей строкой после тега начала скрипта '''<?>'''
## Запустить скрипт стандартным образом: Сформировать печатную форму, рассчитать стоимость доставки, выполнить действие для вызова события.
#'''Что происходит:'''
## При выполнении команды AttachDebugger - скрипт останавливается.
## Отладчик автоматически подключается к перехваченному скрипту.
## Текст скрипта загружается в редактор отладчика.
## Можно ставить точки останова, просматривать переменные и продолжать отладку.

Пример скрипта с запросом подключения к отладчику:
<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Команда `AttachDebugger` должна быть первой командой в скрипте.
* Если режим отслеживания не включён, команда AttachDebugger в скрипте игнорируется и ничего не делает.
* В режиме отслеживания может работать только один отладчик.
* Если скрипт исполняется в шедулере или в другом вспомогательном потоке, то подключится к нему не получится. Отладка работает только в текущем потоке приложения.

== Подпись скрипта ==
При одновременной работе нескольких программистов в отладчике возможны ложные перехваты. Чтобы избежать этого, подпишите скрипт:
AttachDebugger('ЛЮБОЙ ТЕКСТ');
Проверка подписи работает, только если скрипт открыт в отладчике. А строка AttachDebugger в нём совпадает с перехваченным скриптом.

Пример скрипта с подписью:
<source lang="json">
<?>
AttachDebugger('Sergey K. Test script');
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

= Горячие клавиши =

{| class="wikitable"
|-
! Клавиша !! Действие
|-
| '''F9''' || Запустить скрипт в режиме отладки или продолжить исполнение
|-
| '''ESC''' || Аварийная остановка скрипта (удерживать)
|-
| '''F5''' || Добавить или удалить точку останова
|-
| '''Ctrl+F5''' || Добавить наблюдение
|-
| '''Ctrl+S''' || Сохранение изменений в базу данных, если скрипт был открыт для редактирования в отладчике
|-
| '''Ctrl+1..9''' || Перейти в закладку 1 .. 9 в редакторе кода
|-
| '''Ctrl+Shift+1..9''' || Добавить закладку 1 .. 9 в редакторе кода
|-
| '''Ctrl+Shift+U''' || Двигать выбранный блок влево
|-
| '''Ctrl+Shift+I''' || Двигать выбранный блок вправо
|}

= Настройки редактора =

== Перенос строк ==

Контекстное меню редактора > '''Перенос строк'''.

Включает или выключает автоматический перенос длинных строк.
Настройка сохраняется и восстанавливается при следующем запуске отладчика.

== Отображение специальных символов ==

Контекстное меню редактора > '''Показать специальные символы'''.

Показывает пробелы и табуляции в виде специальных символов.
Удобно для поиска лишних пробелов и контроля форматирования кода.

= Примеры использования =

== Пример 1: Отладка скрипта с точками останова ==

'''Задача.''' Проверить корректность простого цикла суммирования. Пример скрипта:
<source lang="json">
<?>
set($i, 10);
set($sum, 0);
while($i > 0,
set($sum, $sum + $i);
set($i, $i - 1)
);
showmessage($sum);
</source>

План действий:
# Откройте отладчик, главное меню '''Отчеты''' > '''SQL''' > '''Выполнить''' > '''Запустить отладчик (F9)'''.
# Введите скрипт
# Установите точку останова на строке set($sum, $sum + $i);.
# '''Запустите скрипт (F9)'''.
# При остановке просмотрите значения $i и $sum в списке переменных.
# Добавьте выражение наблюдения $sum + $i.
# Нажимайте '''Продолжить''', наблюдая, как меняются значения до завершения цикла.

'''Что даёт отладчик:'''
* Видно, как накапливается сумма на каждом шаге.
* Можно быстро обнаружить ошибки в логике цикла.

== Пример 2: Отладка скрипта с условиями ==

'''Задача.''' Проверить, корректно ли выбирается максимум из двух значений. Пример скрипта:
<source lang="json">
<?>
set($a, 10);
set($b, 20);
if($a > $b,
set($result, $a),
set($result, $b)
);
showmessage($result);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке if($a > $b.
# Запустите скрипт (F9).
# При остановке просмотрите значения $a и $b.
# Добавьте выражение наблюдения $a > $b.
# Продолжите выполнение и посмотрите, какое значение попало в $result.

'''Что даёт отладчик:'''
* Понятно, при каких значениях срабатывает та или иная ветка условия.
* Удобно тестировать разные комбинации входных данных.

== Пример 3: Отладка работы с базой данных ==

'''Задача.''' Проверить правильность выборки и обработки данных из базы. Пример скрипта:
<source lang="json">
<?>
new('TSelfADO', 'db');
db.Open('SELECT code FROM city WHERE name Like "%Москва%"');
if(db.RecordCount > 0,
set($code, int(db.FieldByName('code'))),
0
);
showmessage($code);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке if(db.RecordCount > 0.
# Запустите скрипт (F9).
# При остановке просмотрите значение db.RecordCount.
# Добавьте выражение наблюдения db.FieldByName('code').
# Продолжите выполнение и убедитесь, что в $code попало ожидаемое значение.

'''Что даёт отладчик:'''
* Видно, сколько записей вернул запрос.
* Можно проверить конкретные значения полей перед дальнейшей обработкой.

== Пример 4: Отладка скрипта через AttachDebugger ==

'''Задача.''' Подключиться к скрипту запущенному без отладчика.
Пример скрипта:
<source lang="json">
<?>
AttachDebugger;
new('TSelfADO', 'db');
db.Open('SELECT COUNT(*) as cnt FROM address WHERE date_put IS NULL');
set($count, int(db.FieldByName('cnt')));
if($count > 100,
showmessage('Внимание! Много недоставленных адресов!'),
0
);
</source>

План действий:
# Откройте отладчик скриптов.
# Включите режим отслеживания меню '''Файл''' > '''Ожидать команды AttachDebugger'''.
# Откройте '''Отчеты''' > '''SQL''' введите скрипт из примера.
# Запустите скрипт через меню '''Выполнить''' > '''Выполнить как скрипт (F7)'''.
# Когда выполнение дойдёт до AttachDebugger, отладчик автоматически подключится.
# Установите точку останова на строке if($count > 100.
# Продолжите выполнение и проанализируйте значение $count.

'''Что даёт отладчик:'''
* Можно разбирать сценарии, которые запускаются не из отладчика, а из печтаных форм, дополнительных услуг и т.д.
* Скрипт становится доступен для анализа так же, как и обычный скрипт, запущенный из отладчика.

== Пример 5: Отладка скрипта с циклом FOR ==

'''Задача.''' Проверить корректность вычислений в цикле FOR. Пример скрипта:
<source lang="json">
<?>
set($sum, 0);
for($i, 1, 10,
set($sum, $sum + $i)
);
showmessage($sum);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке set($sum, $sum + $i);.
# Запустите скрипт (F9) и просматривайте значения $i и $sum при остановках.
# Добавьте выражение наблюдения $sum + $i для контроля вычислений.

'''Что даёт отладчик:'''
* Пошагово видно, как формируется итоговая сумма.
* Удобно находить ошибки в граничных условиях цикла.

== Пример 6: Использование выражений наблюдения ==

'''Задача.''' Одновременно контролировать несколько взаимосвязанных значений. Пример скрипта:
<source lang="json">
<?>
set($a, 10);
set($b, 20);
set($c, 30);
set($result, $a + $b + $c);
showmessage($result);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке set($result, $a + $b + $c);.
# Запустите скрипт (F9).
# Добавьте выражения наблюдения:
#* $a + $b
#* $b + $c
#* $a + $b + $c
# При остановке сравните значения выражений и итоговый результат.

'''Что даёт отладчик:'''
* Одновременно видно несколько ключевых показателей.
* Легче находить расхождения между промежуточными и итоговыми значениями.

Отладчик встроенных скриптов

2026-03-17T16:16:22Z

Sammy: /* Подключение отладчика к работающим скриптам */

= Интерфейс =

[[Файл:ScriptDebugger.png]]

'''Отладчик скриптов''' — рабочий инструмент для разработки и диагностики [[Руководство_программиста|скриптов встроенного языка]].
Он позволяет запускать скрипты в режиме отладки, останавливать выполнение на нужных строках, анализировать переменные и подключаться к уже запущенным скриптам.
Вы можете запустить отладчик из:
* Через меню '''Отчеты > SQL > Выполнить > Запустить отладчик'''.
* Через меню '''Отчеты > Дополнительные возможности > Редактировать'''.
* Горячей клавишей '''Ctrl+Alt+D''' в главном окне приложения.

= Основные возможности =

* '''Запуск в режиме отладки''' — выполнение скрипта с остановкой на заданных строках
* '''Просмотр переменных''' — автоматическое отображение значений всех переменных при остановке
* '''Наблюдение за выражениями''' — вычисление произвольных выражений при каждой остановке
* '''Точки останова''' — остановка выполнения на выбранных строках кода
* '''Подключение к скриптам''' — подключение к скрипту запущенному без отладчика
* '''Работа с файлами''' — открытие, сохранение и отслеживание изменений файлов скриптов
* '''Расширенный редактор''' - подсветка парных скобок, отображение скрытых симолов, закладки.

= Интерфейс отладчика =

== Редактор кода ==

Основная область для написания и редактирования скрипта. Редактор поддерживает:
* Подсветку синтаксиса
* Нумерацию строк
* Визуальное отображение точек останова (красные кружки в левом поле)
* Подсветку текущей строки выполнения (желтый фон)
* Подсветку парных скобок
* Отображение скрытых символов
* Закладки для быстрой навигации
== Лог ==

Отображает:
* Вывод сообщений напрямую из скрипта командой '''print'''
* Сообщения отладчика (остановка на breakpoint, ошибки)

== Кнопки управления ==

* '''Запустить''' — Запуск скрипта в режиме отладки (F9). При необходимости установите точки останова, cкрипт выполнится до первой точки останова или до ошибки.
* '''Остановить''' — Прерывание дальнейшего исполнения скрипта. Во время выполнения скрипта можно нажать и удерживать клавишу '''ESC''' для аварийной остановки.
* '''Продолжить''' — Возобновление выполнения после остановки скрипта (F9)

= Работа с отладчиком =

== Установка точек останова ==
Точки останова можно настроить перед запуском скрипта или когда выполнение скрипта приостановлено. Добавление точки останова:

'''Способ 1.''' Щёлкните левой кнопкой мыши в левой части нужной строки (область номеров строк). На строке появится красный кружок — точка останова установлена. Повторный щелчок удалит её.

'''Способ 2.''' Установите курсор на строку и используйте пункт меню '''Скрипт''' > '''Добавить точку останова (F5)'''.

== Просмотр переменных ==

Список '''Переменные''' содержит все переменные и объекты доступные в текущем инстансе интерпретатора. Список автоматически отображаются в момент остановки выполнения скрипта.

== Наблюдение за выражениями ==
Список '''Наблюдения''' показывает все добавленные пользователям выражения и их рассчитанные значения. Значения обновляются автоматически в момент остановки выполнения скрипта или после редактирования выражения. Для добавления наблюдения:
# Выделите текст в редакторе (например, имя переменной или выражение)
# Выберите в контекстном меню редактора пункт '''Добавить в наблюдение'''
# Либо используйте меню '''Скрипт''' > '''Добавить наблюдение (Сtrl+F5)''' и введите выражение вручную.

'''Примеры выражений:'''
* $a + $b — сумма переменных
* db.RecordCount — количество записей в наборе данных
* $i > 0 — логическое условие

= Работа с файлами =

== Открытие файла с отслеживанием ==

Меню '''Файл''' > '''Открыть и отслеживать'''.

Открывает файл скрипта и включает автоматическое отслеживание изменений на диске.
При изменении файла во внешнем редакторе текст автоматически обновляется в отладчике.

== Сохранение в файл ==

Всегда есть возможность сохранить скрипт в файл.
* Меню '''Файл''' > '''Сохранить в файл''' — Сохраняет текущий текст скрипта в файл. Если файл был сохранен ранее, по умолчанию предлагается предыдуший путь.

* Меню '''Файл''' > '''Сохранить (Ctrl+S)''' — Когда отладчик открыт без привязки к конкретному скрипту, то сохраняет изменения в файл.
'''Важно!''' Если отладчик открыли например из '''Отчеты''' > '''Дополнительные возможности''' > '''Редактировать''' то сохранения через пункт '''Сохранить (Ctrl+S)''' сохранения '''всегда''' будет происходить в базу, в файл изменения сохранены не будут.

= Сохранение =

Если отладчик открыт как редактор скрипта, доступны функции по сохранению напрямую в базу данных:
* Меню '''Файл''' > '''Сохранить (Ctrl+S)''' — сохранить скрипт в базу данных
* Кнопка '''Сохранить и закрыть''' — сохранить скрипт и закрыть окно отладчика

= Подключение отладчика к работающим скриптам =
Данная возможность позволяет подключить отладчик к скриптам изначально запущеным без него. Для начала работ, отладчик нужно перевести в режим '''ожидания запросов отладки'''. Далее необходимо запустить скрипт стандартным способом. Если в скрипте будет команда AttachDebugger - отладчик это увидит и начнется процесс отладки этого скрипта. Это удобно для отладки скриптов, которые работают в своем контексте:
* [[Печатные формы|Скриптов из печатных форм]]
* [[Дополнительные_возможности|Скриптов из системных событий]]
* [[Пользовательские_отчеты|Скриптов дополнительных возможностей]]
* [[Дополнительные услуги|Скриптов из дополнительных услуг]]

'''Как использовать'''

#'''В отладчике:'''
## Откройте отладчик скриптов, главное меню '''Отчеты''' > '''SQL''' > '''Выполнить''' > '''Запустить отладчик (F9)'''.
## Включите режим отслеживания: меню '''Файл''' > '''Ожидать команды AttachDebugger'''.
## В строке состояния отладчика появится сообщение '''Ожидание команды AttachDebugger...'''.
## Свернуть отладчик, если его закрыть то наблюдение остановится.
#'''В скрипте:'''
## Скрипт нужно подготовить. В скрипте нужно прописать команду '''AttachDebugger''' она должна быть '''первой командой''' или идти следующей строкой после тега начала скрипта '''<?>'''
## Запустить скрипт стандартным образом: Сформировать печатную форму, рассчитать стоимость доставки, выполнить действие для вызова события.
#'''Что происходит:'''
## При выполнении команды AttachDebugger - скрипт останавливается.
## Отладчик автоматически подключается к перехваченному скрипту.
## Текст скрипта загружается в редактор отладчика.
## Можно ставить точки останова, просматривать переменные и продолжать отладку.

Пример скрипта с запросом подключения к отладчику:
<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Команда `AttachDebugger` должна быть первой командой в скрипте.
* Если режим отслеживания не включён, команда AttachDebugger в скрипте игнорируется и ничего не делает.
* В режиме отслеживания может работать только один отладчик.
* Если скрипт исполняется в шедулере или в другом вспомогательном потоке, то подключится к нему не получится. Отладка работает только в текущем потоке приложения.

При одновременной работе нескольких программистов в отладчике возможны ложные перехваты. Чтобы избежать этого, подпишите скрипт:
AttachDebugger('ЛЮБОЙ ТЕКСТ');
Проверка подписи работает, только если скрипт открыт в отладчике. А строка AttachDebugger в нём совпадает с перехваченным скриптом.

= Горячие клавиши =

{| class="wikitable"
|-
! Клавиша !! Действие
|-
| '''F9''' || Запустить скрипт в режиме отладки или продолжить исполнение
|-
| '''ESC''' || Аварийная остановка скрипта (удерживать)
|-
| '''F5''' || Добавить или удалить точку останова
|-
| '''Ctrl+F5''' || Добавить наблюдение
|-
| '''Ctrl+S''' || Сохранение изменений в базу данных, если скрипт был открыт для редактирования в отладчике
|-
| '''Ctrl+1..9''' || Перейти в закладку 1 .. 9 в редакторе кода
|-
| '''Ctrl+Shift+1..9''' || Добавить закладку 1 .. 9 в редакторе кода
|-
| '''Ctrl+Shift+U''' || Двигать выбранный блок влево
|-
| '''Ctrl+Shift+I''' || Двигать выбранный блок вправо
|}

= Настройки редактора =

== Перенос строк ==

Контекстное меню редактора > '''Перенос строк'''.

Включает или выключает автоматический перенос длинных строк.
Настройка сохраняется и восстанавливается при следующем запуске отладчика.

== Отображение специальных символов ==

Контекстное меню редактора > '''Показать специальные символы'''.

Показывает пробелы и табуляции в виде специальных символов.
Удобно для поиска лишних пробелов и контроля форматирования кода.

= Примеры использования =

== Пример 1: Отладка скрипта с точками останова ==

'''Задача.''' Проверить корректность простого цикла суммирования. Пример скрипта:
<source lang="json">
<?>
set($i, 10);
set($sum, 0);
while($i > 0,
set($sum, $sum + $i);
set($i, $i - 1)
);
showmessage($sum);
</source>

План действий:
# Откройте отладчик, главное меню '''Отчеты''' > '''SQL''' > '''Выполнить''' > '''Запустить отладчик (F9)'''.
# Введите скрипт
# Установите точку останова на строке set($sum, $sum + $i);.
# '''Запустите скрипт (F9)'''.
# При остановке просмотрите значения $i и $sum в списке переменных.
# Добавьте выражение наблюдения $sum + $i.
# Нажимайте '''Продолжить''', наблюдая, как меняются значения до завершения цикла.

'''Что даёт отладчик:'''
* Видно, как накапливается сумма на каждом шаге.
* Можно быстро обнаружить ошибки в логике цикла.

== Пример 2: Отладка скрипта с условиями ==

'''Задача.''' Проверить, корректно ли выбирается максимум из двух значений. Пример скрипта:
<source lang="json">
<?>
set($a, 10);
set($b, 20);
if($a > $b,
set($result, $a),
set($result, $b)
);
showmessage($result);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке if($a > $b.
# Запустите скрипт (F9).
# При остановке просмотрите значения $a и $b.
# Добавьте выражение наблюдения $a > $b.
# Продолжите выполнение и посмотрите, какое значение попало в $result.

'''Что даёт отладчик:'''
* Понятно, при каких значениях срабатывает та или иная ветка условия.
* Удобно тестировать разные комбинации входных данных.

== Пример 3: Отладка работы с базой данных ==

'''Задача.''' Проверить правильность выборки и обработки данных из базы. Пример скрипта:
<source lang="json">
<?>
new('TSelfADO', 'db');
db.Open('SELECT code FROM city WHERE name Like "%Москва%"');
if(db.RecordCount > 0,
set($code, int(db.FieldByName('code'))),
0
);
showmessage($code);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке if(db.RecordCount > 0.
# Запустите скрипт (F9).
# При остановке просмотрите значение db.RecordCount.
# Добавьте выражение наблюдения db.FieldByName('code').
# Продолжите выполнение и убедитесь, что в $code попало ожидаемое значение.

'''Что даёт отладчик:'''
* Видно, сколько записей вернул запрос.
* Можно проверить конкретные значения полей перед дальнейшей обработкой.

== Пример 4: Отладка скрипта через AttachDebugger ==

'''Задача.''' Подключиться к скрипту запущенному без отладчика.
Пример скрипта:
<source lang="json">
<?>
AttachDebugger;
new('TSelfADO', 'db');
db.Open('SELECT COUNT(*) as cnt FROM address WHERE date_put IS NULL');
set($count, int(db.FieldByName('cnt')));
if($count > 100,
showmessage('Внимание! Много недоставленных адресов!'),
0
);
</source>

План действий:
# Откройте отладчик скриптов.
# Включите режим отслеживания меню '''Файл''' > '''Ожидать команды AttachDebugger'''.
# Откройте '''Отчеты''' > '''SQL''' введите скрипт из примера.
# Запустите скрипт через меню '''Выполнить''' > '''Выполнить как скрипт (F7)'''.
# Когда выполнение дойдёт до AttachDebugger, отладчик автоматически подключится.
# Установите точку останова на строке if($count > 100.
# Продолжите выполнение и проанализируйте значение $count.

'''Что даёт отладчик:'''
* Можно разбирать сценарии, которые запускаются не из отладчика, а из печтаных форм, дополнительных услуг и т.д.
* Скрипт становится доступен для анализа так же, как и обычный скрипт, запущенный из отладчика.

== Пример 5: Отладка скрипта с циклом FOR ==

'''Задача.''' Проверить корректность вычислений в цикле FOR. Пример скрипта:
<source lang="json">
<?>
set($sum, 0);
for($i, 1, 10,
set($sum, $sum + $i)
);
showmessage($sum);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке set($sum, $sum + $i);.
# Запустите скрипт (F9) и просматривайте значения $i и $sum при остановках.
# Добавьте выражение наблюдения $sum + $i для контроля вычислений.

'''Что даёт отладчик:'''
* Пошагово видно, как формируется итоговая сумма.
* Удобно находить ошибки в граничных условиях цикла.

== Пример 6: Использование выражений наблюдения ==

'''Задача.''' Одновременно контролировать несколько взаимосвязанных значений. Пример скрипта:
<source lang="json">
<?>
set($a, 10);
set($b, 20);
set($c, 30);
set($result, $a + $b + $c);
showmessage($result);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке set($result, $a + $b + $c);.
# Запустите скрипт (F9).
# Добавьте выражения наблюдения:
#* $a + $b
#* $b + $c
#* $a + $b + $c
# При остановке сравните значения выражений и итоговый результат.

'''Что даёт отладчик:'''
* Одновременно видно несколько ключевых показателей.
* Легче находить расхождения между промежуточными и итоговыми значениями.

Оборудование

2026-03-12T15:42:10Z

Sammy: /* Настройка весов Mettler Toledo */

== Аппаратные требования к рабочей станции ==
* Работа под управлением ОС Windows 32/64 Bit: Win7, Win8; Win10; Win11.
* Установленный и активированный пакет Microsoft Office 2007 или выше '''кроме «Office 2010 Starter»'''.
* Процессор: любой, удовлетворяющий рабочим требованиям линейки ОС Windows.
* Оперативное запоминающее устройство (ОЗУ): от 2 Gb и выше.
* Запоминающее устройство HDD или SSD: от 60 GB и выше.
* Сетевой интерфейс: проводной/беспроводной Ethernet интерфейс.
* Монитор: диагональ, обеспечивающая разрешающую способность экрана не менее 1024*768 пикселей.
* Периферийные порты ввода-вывода USB, RS232 (при необходимости наличия таковых): для подключения периферийного оборудования (сканер штрихкодов, фискальный регистратор, термопринтер).
* Клавиатура, манипулятор мышь.

== Выбор сервера для системы ==

=== Выбор серверного оборудования ===
Система MeaSoft нетребовательна к аппаратным ресурсам сервера.

Что касается '''производительности''', то для небольшой компании, человек 10 в офисе, как правило, производительности бытового ноутбука, установленного в качестве сервера, будет более, чем достаточно. То есть серверную часть можно установить на любую машину, за которой работает пользователь. Для компаний до 20 сотрудников мы рекомендуем использовать бытовой компьютер, но «назначенный» сервером, то есть чтобы он стоял отдельно работал круглосуточно, и им никто не пользовался в качестве рабочей станции. Для компаний более 20 человек — лучше использовать именно серверное оборудование, хотя у нас есть установка, где на бытовом Core i3 одновременно работает 80 человек.

'''Объем диска''': Изначально при установке БД занимает около 1 Gb. Далее она увеличивается в зависимости от использования. Если компания доставляет 20000 отправлений в месяц, через 3 года объем базы будет 10 Gb с одной оговоркой: Больше всего места в БД занимают файлы, такие, как архив отсканированных накладных, отправленные по почте отчеты и счета, и т. д. Здесь, если компания использует эти возможности, она за год может накопить и 100 и 200 Gb. Так же необходимо учитывать некоторый объем свободного места, необходимый для создания резервных копий, а так же для работы самой ОС.

Самое главное требование системы к серверу — это его '''надежность'''. Надо понимать, что при поломке сервера приостановится работа всей компании. В худшем случае — можно потерять данные, введенные с момента последней резервной копии. Для сокращения возможных рисков, нужно стараться, по возможности, делать сервер максимально надежным:

* Мы не рекомендуем устанавливать сервер на ноутбук, так как его форм-фактор предполагает некоторую степень мобильности. Есть соблазн взять его куда-то с собой. А при перемещении велик риск его потери, кражи, его можно уронить и разбить. Еще один фактор низкой надежности ноутбуков — они часто умирают от пролитого на них чая/кофе/пива.
* Мы не рекомендуем устанавливать серверную часть на компьютер, за которым работает пользователь. Здесь главный фактор риска — это заражение компьютера вирусами, которые пользователь, по неграмотности, скачивает из интернета, приносит на флешках и т. д. Антивирус никакой от этого не спасает.
* Мы рекомендуем устанавливать на серверный компьютер [https://ru.wikipedia.org/wiki/RAID Raid-1] массивы для снижения вероятности выхода из строя/потери данных в случае поломки жесткого диска. Однако нужно понимать, что это тоже не панацея: жесткие диски достаточно часто выходят из строя все одновременно, например, при поломке блока питания, когда напряжение «пробивает» через него и приводит к выгоранию всех компонентов компьютера, В случае стихийных бедствий и несчастных случаев (прорывы в трубах, например), или просто от того, что 2 HDD одной модели, купленные одновременно имеют одинаковый ресурс наработки на отказ.
* Мы рекомендуем устанавливать [https://ru.wikipedia.org/wiki/Источник_бесперебойного_питания ИБП] на сервер для предохранения его от скачков напряжения в сети и/или аварийного завершения работы при отключении питания.
* Мы рекомендуем использовать специализированное серверное оборудование, так как оно по определению гораздо надежнее, вплоть до резервирования блоков питания. Но такое оборудование достаточно дорогое, и его использование носит исключительно рекомендательный характер.

Некоторые наши клиенты не удовлетворяются вышеизложенными рекомендациями по выбору серверного оборудования и просят нас предоставить формальные требования к серверу. Вот они:

1. Работа под управлением ОС Windows 2012 Server R2; 
2. Процессор: многоядерный, удовлетворяющий требованиям ОС; 
3. Оперативное запоминающее устройство (ОЗУ): от 4 GB; 
4. Запоминающее устройство HDD: от 360 Gb, Raid-1; 
5. Сетевой интерфейс: проводной Ethernet интерфейс — 100 Mbit.; 
6. Монитор, с разрешением минимум 1024*768; 
7. Клавиатура microsoft минимум 103 клавиши; 
8. Мышь оптическая; 
9. Колонки активные минимум 2 Вт; 
10. Коврик для мыши силиконовый :-) 

=== Выбор серверной операционной системы ===
Серверная часть MeaSoft работает практически на любой операционной системе. Исключение — модуль интеграции с внешними системами.

При выборе ОС нужно рассмотреть все плюсы и минусы. Обычно выбор стоит между Windows и Linux.

Windows — платная система. Серверная Windows стоит 40-45 т.р. Система прекрасно работает, например, на Windows 7 (желательно только не домашнюю версию), которая стоит в разы меньше. Ограничение на количество подключений к ней не имеет отношения к нашей системе.

Linux — «бесплатная» система. Почему в кавычках? Потому что стоимость владения им гораздо выше: для администрирования системы linux необходим системный администратор с глубокими познаниями этой ОС, а такие специалисты стоят в 2 раза дороже, чем администраторы Windows.

Таким образом даже «дорогая» серверная Windows окупается за пару месяцев. Linux можно выбирать только в том случае, если в вашей компании и так уже работает несколько системных администраторов Linux, которые смогут решать возможные проблемы с ней. Наша компания оказывает необходимую для работы системы помощь в администрировании windows-серверов, но с linux эта функция полностью ложится на заказчика. Почему мы говорим, что должно быть несколько администраторов в случае с Linux? Потому что в случае увольнения единственного администратора, как правило, компанию ждут времена несчастий, пока не найдется новый ТОЛКОВЫЙ системный администратор.

Резюме: Выбирайте Linux только в том случае, если вы точно уверены в том, что делаете. В противном случае — только Windows.

=== Размещение сервера ===
Для классической архитектуры системы, когда офис-склад консолидированы в одном месте, мы рекомендуем размещение сервера в офисе. То есть в точке максимального использования системы. Это обеспечивает максимальную скорость и надежность. При этом при необходимости удаленного доступа к системе — достаточно, имея внешний статичный IP-адрес, «пробросить» порт 3306 на сервер.

В последнее время все больше популярность приобретает размещение сервера «в облаке». На самом деле формально — это, конечно, не [https://ru.wikipedia.org/wiki/Облачное_хранилище_данных облако] в широком понимании, а [https://ru.wikipedia.org/wiki/VPS сервер], физический или виртуальный, находящийся в дата-центре. При выборе такого варианта установки программы следует учесть ряд факторов:
* '''Скорость доступа''' Наша система очень чувствительна к скорости доступа. Некоторые операции могут вызывать несколько обращений к серверу, и увеличение времени одного обращения на несколько миллисекунд существенно снижает общую производительность системы на рабочем месте. При размещении сервера в дата-центрах Европы, например, скорость доступа ([https://ru.wikipedia.org/wiki/Ping ping]) из Москвы составляет 50-60 мс. Это — на грани возможности использования программы. При размещении в дата-центре того же города, где находятся пользователи, время доступа — порядка 3-5 мс. Для сравнения — доступ по локальной сети — менее 1 мс.
* '''Надежность интернет-канала''' Нужно понимать, что в случае размещения сервера в интернете система не будет работать у вас в офисе и/или на складе в случае отсутствия доступа в интернет. Желательно обеспечить резервирование канала, причем, желательно, не 3G-«свистком» (см. следующие 2 пункта).
* '''Пропускная способность интернет-канала''' При разработке системы мы стараемся минимизировать объемы информации, передаваемые между рабочим местом и сервером. Но если доступ происходит через интернет, на одном канале работает несколько человек, на котором работает и программа и телефоны, а кто-то смотрит видео в ютубе, а кто-нибудь еще придумает пользоваться торрентами — работа остановится.
* '''Стабильность интернет-канала''' При доступе к серверу не должны теряться пакеты. Если на канале происходят потери — программа будет закрываться с сообщением о том, что произошла потеря соединения с сервером. Потери пакетов можно проанализировать командой ping -t <имя_сервера, например ya.ru>.
* '''Надежность дата-центра''' Теоретически — в дата-центре обеспечивается резервирование и электропитания, и каналов передачи данных. Естественно, в них стоят и промышленные климатические системы, поддерживающие заданную рабочую температуру всего оборудования. Но на практике часто бывает, что сервер оказывается недоступным на время от нескольких минут до нескольких дней. Техподдержка (если ее телефон вообще отвечает, а часто как раз в эти моменты она не работает — либо потому, что телефония работает на том же канале, который у них и «упал», либо потому, что тысячи пользователей серверов, обнаружив неполадки, начали им одновременно звонить) скажет «да, в вашем сегменте технические неполадки, мы устраняем», и больше сделать вы ничего не сможете. В случае, если сервер стоит у вас в офисе — вы сами принимаете моментальные меры. Вплоть до того, что можно вынуть из сгоревшего сервера жесткий диск, подключить к другому компьютеру, и восстановить работу системы.
* '''Стоимость''' При размещении на linux-VDS серверах стоимость на текущий момент — [http://firstvds.ru/products/vds_vps_hosting 600-900 руб/мес], Windows — [https://masterhost.ru/service/hosting/vps/ 4000 руб/мес]. По поводу выбора ОС читайте соответствующий раздел этой же статьи.

Отсюда вывод:
Мы рекомендуем устанавливать сервер «в облаке» только в случае сильно распределенной структуры компании. Когда максимальную скорость и надежность нужно обеспечить множеству удаленных пользователей, а не в одном конкретном месте.

== Доступ для установки системы ==

Для установки системы программисту MeaSoft требуется доступ к вашему серверу с правами администратора. В процессе установки потребуется устанавливать службы, запускать и останавливать их, а также производить запуск приложений от имени администратора. Доступ можно предоставить одним из способов:
* по [https://remontka.pro/microsoft-remote-desktop/ RDP] — передайте нам IP-адрес сервера, порт (если он отличается от стандартного), логин и пароль для подключения;
* через [https://www.teamviewer.com/ru/info/remote-desktop/ TeamViewer] — установите и запустите программу на сервере и передайте нам ID и пароль подключения.

== Рекомендованное периферийное оборудование ==

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

Мы рекомендуем:
* Zebex Z-3000 (CCD-сканер) — дешевый;
* Honeywell (Metrologic) 5145 Eclipse — лазерный;
* Honeywell (Metrologic) DS6707 — image, позволяет сканировать 2D-штрихкоды;
* Honeywell (Metrologic) 1202g Voyager BT — радиосканер, позволяет сканировать на расстоянии от компьютера.

Рекомендуются к приобретению сканеры с типом подключения USB HID.

Вы можете скачать наше бесплатное мобильное приложение [[Кладовщик — мобильное приложение для Android|Кладовщик]], которое работает как сканер штрихкодов.

Если вы определились с моделью сканера, то тип подключения не играет существенной роли: наша программа позволяет работать с любой из списка поддерживаемых моделей (проводной или беспроводной). Выбор интерфейса, скорее всего, зависит от наличия и доступности соответствующего порта на компьютере пользователя (так, интерфейс RS-232 предполагает наличие COM-порта, а интерфейс KBW, как правило, PS/2). Очевидным является тот факт, что наиболее универсальным будет сканер, работающий через интерфейс USB (USB HID).

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

При выборе сканера обратите внимание на то, что при типе подключения USB HID (рекомендуется) или «разрыв клавиатуры» сканер требует некоторой настройки. [[#Подключение и настройка сканеров штрихкодов|В разделе ниже]] приведены программирующие листы для различных моделей сканеров. Если вы покупаете сканер не из списка, для которого есть программирующий лист, будьте готовы к тому, что потребуется создание такого листа. Для его создания нужно полное руководство по программированию конкретного сканера на русском или английском языках. С этим часто бывают проблемы, если вы покупаете сканеры с доставкой из Китая — они, как правило, настолько китайские, что у них нет ни документации, ни сайта производителя. В таком случае остается уповать только на везение.

=== Термопринтер ===
Поддерживаются любые термо- и термо-трансферные принтеры. 
Рекомендуется термопринтер Zebra ZD410 — у него ширина печатающей головки 60 мм, поэтому ленту такой же ширины сложно вставить неправильно. Очень прост в обслуживании и заправке ленты. 
'''ВНИМАНИЕ!''' При покупке следует учитывать, что термопринтеры не комплектуются USB-шнуром и этикетками, поэтому их необходимо приобрести отдельно. Рекомендуем этикетки размером 58×40 мм.

=== Весы ===
Поддерживаемые весы:
* [[#Настройка весов МЕРА|МЕРА]] — подходят модели, которые поддерживают протоколы «ОКА», «9 байт» или «Mera Avto». По нашим сведениям, протоколы ОКА и Mera Avto поддерживают весы, у которых есть цифровая клавиатура 0-9. Но лучше уточняйте у продавца. Протокол «9 байт» в силу своей низкоуровневой работы с COM-портом может не работать через USB-переходники. Рекомендуем весы Мера ВП-3/30 — небольшие, точные, недорогие. 
* [[#Настройка весов НЕВА|Нева]]
* ExpressCube
* Масса-К
* InSize
* Мастер-Кит
* CAS HD 57583
* UIS Metrix

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

Инструкцию по настройке и подключению весов смотрите в этой статье [[#Настройка весов|ниже]].

=== Фискальный регистратор ===
В рамках 54-ФЗ поддерживается и рекомендуется работа с сервисом удаленной фискализации LIFE PAY.

Поддерживаются все фискальные регистраторы фирмы «Штрих-М»

Рекомендуется ШТРИХ-LIGHT-ФР-К (cамый бюджетный)

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

=== Банковский POS-терминал ===
[https://ru.wikipedia.org/wiki/POS-%D1%82%D0%B5%D1%80%D0%BC%D0%B8%D0%BD%D0%B0%D0%BB POS-терминал].
Мобильное приложение поддерживает интеграцию с сервисами IBox, LIFE PAY, а также поддерживается работа с независимыми POS-терминалами.

=== Планшетный сканер ===
Применяется для сканирования ведомостей с подписью, после чего полученные документы вы можете прикрепить в программе к соответствующей корреспонденции. 
Рекомендуются сканеры с автоматической подачей. 
При выборе устройства обратите внимание на следующие характеристики:
* Скорость сканирования;
* Наличие функции обнаружения подачи двух листов;
* Двухстороннее сканирование;
* Количество сканирований до отказа.

=== Монитор ноутбука/нетбука/компьютера ===
Рабочее место пользователя для работы с MeaSoft должно оснащаться монитором с разрешающей способностью экрана не менее 1024*768 пикселей. При работе на портативных устройствах, таких как нетбуки, у которых разрешение ниже рекомендуемого, в экран могут не помещаться некоторые окна.

=== Штрихкодовая линейка-угол ===
Штрихкодовая линейка-угол применяется для обмера габаритов отправления. Обмер можно производить при приеме корреспонденции на склад (F10 на вкладке «Заказы»). Каждое деление (1, 5 или 10 миллиметров) линейки промаркировано своим штрихкодом. Прикладывая товар к линейке и сканируя штрихкод, соответствующий краю товара, получаем размеры. Чтобы включить поддержку штрихкодированной линейки, нужно в окне приема, нажать кнопку «Настройки» и установить галку «Включить поддержку штрихкодированной линейки». Для работы с линейкой удобнее использовать лазерные сканеры, у них полоса считывания наводится точно на нужный штрихкод. Реализована поддержка производителя [http://cortes.ru/shtrihcode/barcodeline.php Кортес]. Перед покупкой нужно проверять модель на совместимость с системой. Система поддерживает следующий формат ШК: 
Длина ШК 7 символов, начинается всегда на «29», например: 291XXXX, 292XXXX, 293XXXX 
где: XXXX — значение в милиметрах, 3-й знак — направление измерения от 1 до 3, то есть координата (длина, ширина, высота).

=== Терминал сбора данных ===
Терминал сбора данных (ТСД) под управлением Android может работать совместно с MeaSoft как сканер штрихкодов или ТСД. Для этого установите на ТСД наше приложение [[Мобильное приложение кладовщика для Android|Кладовщик]] и выберите нужный режим работы.

== Подключение и настройка сканеров штрихкодов ==
MeaSoft поддерживает все виды [http://ru.wikipedia.org/wiki/Сканер_штрихкода сканеров штрихкодов], поэтому при выборе сканера следует учитывать особенности штрихкодов, которыми заказчики маркируют корреспонденцию. В частности, контактные светодиодные сканеры можно использовать для считывания штрихкодов длиной не более 5-7 см (в зависимости от модели сканера), а для двухмерных штрихкодов необходим image-сканер.

При подключении в разрыв клавиатуры или в порт USB в режиме эмуляции разрыва клавиатуры требуется небольшая дополнительная настройка сканера. Для этого существуют специальные программирующие листы (см. ниже) для разных моделей сканеров, на которых напечатаны штрихкоды в определенной последовательности. Просканируйте их в том порядке, в котором они расположены на листе. Как правило, для сканеров одной фирмы подходят одни и те же штрихкоды.
В результате этих действий при каждом сканировании перед штрихкодом вставляется определенный префикс, наличие которого для программы является признаком того, что данная последовательность символов введена с помощью сканера. Для использования в качестве префикса в программе зарезервирована клавиша с буквой «ё», что накладывает некоторое ограничение: невозможно ввести с клавиатуры символы «ё», «Ё», «`», «~».

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

{| class="wikitable" style="width: 60%
!style="width: 30%;"|Бренд
!style="width: 70%;"|Модель
|-
|Argox
|[https://www.courierexe.ru/download/scaner/Argox.doc ArgoScan 8000/8110/8120/8150/8250/8310/8312, argox as-8020cl (usb))]
|-
|Champtek
|[https://www.courierexe.ru/download/scaner/Champtek.doc Champtek]
|-
|Cino
|[https://www.courierexe.ru/download/scaner/Cino.doc F680BT]
|-
|Cipherlab
|[https://www.courierexe.ru/download/scaner/Cipherlab_1021_(simple).doc 1021 (simple)] [https://www.courierexe.ru/download/scaner/Cipherlab_1021_(simple)_and_back.doc 1021 с переключением обратно] [https://www.courierexe.ru/download/scaner/Cipherlab_1560,_1562,_1070_(bluetooth).doc 1560, 1562, 1070 (bluetooth)]
|-
|Metrologic/Eclipse/Honeywell/Motorola/Symbol/Youjie
|[https://www.courierexe.ru/download/scaner/Honeywell_Xenon_1900.doc Xenon 1900, Voyager 1202g, YJ4600] [https://www.courierexe.ru/download/scaner/Metrologic,_Eclipse,_Honeywell,_ms9520,_ms9540.doc MS5145, MS9520, MS9540, HH440] [https://www.courierexe.ru/download/scaner/Symbol_ls1203,_LS2208.doc LS1203, LS2208] (подходит для li4278, Zebra DS2278) [https://www.courierexe.ru/download/scaner/Symbol_ds6707.doc DS6707] [https://www.courierexe.ru/download/scaner/honeywell_1452g.docx Honeywell Voyager 1452G] [https://www.courierexe.ru/download/scaner/honeywell_1472g.docx Honeywell 1472g]
|-
|PayTor
|[https://www.courierexe.ru/download/scaner/Paytor%20DS%201009.docx DS 1009]
|-
|Proton
|[https://www.courierexe.ru/download/scaner/Proton.doc Proton]
[https://www.courierexe.ru/download/scaner/Proton_2.doc IMS3190, беспроводной)]
|-
|Datalogic
|[https://www.courierexe.ru/download/scaner/PSC,_Datalogic_QS2500.doc PSC, Datalogic QS2500] [https://www.courierexe.ru/download/scaner/qd2100.doc QD2100] 
[https://www.courierexe.ru/download/scaner/datalogic800i.docx Magellan 800i] 
[https://www.courierexe.ru/download/scaner/QuickScanMobile.doc Mobile: QM2100, M2]
|-
|Scanport
|[https://www.courierexe.ru/download/scaner/Scanport_T600.bmp T600]
|-
|Zebex
|[https://www.courierexe.ru/download/scaner/Zebex_4.bmp Zebex]
|-
|Godex
|[https://www.courierexe.ru/download/scaner/godex.doc GS550U]
|-
|Mercury
|[https://www.courierexe.ru/download/scaner/mercury.doc CL-200] [https://www.courierexe.ru/download/scaner/Mercury_1100PL.docx 1100PL]
|-
|Если у вас китайский безымянный (беспроводной?) сканер, попробуйте этот лист
|[https://www.courierexe.ru/download/scaner/Vioteh.doc Vioteh VT2208R, Dudian CT980N, bp8150s, Heroje B120G]
|-
|Vioteh
|[https://www.courierexe.ru/download/scaner/VT2205_VT2209.docx VT2205 VT2209]
|-
|Heroje
|[https://www.courierexe.ru/download/scaner/Heroje_H018.doc H018]
|-
|Производитель Китай под российским брендом АТОЛ. 
Cканер не рекомендуется к покупке. Атол выпускает несколько разных версий сканера под одной моделью SB1101. К сожалению, не все модели поддаются настройке.
|[https://www.courierexe.ru/download/scaner/Atol_SB_1101.docx SB 1101] [https://www.courierexe.ru/download/scaner/Atol_SB_1103.docx 1103]
|-
|Radall
|[https://www.courierexe.ru/download/scaner/Radall_RD-h8_2d.docx RD-h8 2d]
|-
|NETUM
|[https://www.courierexe.ru/download/scaner/NETUM_W6.docx W6, C750]
|-
|DBS
|[https://www.courierexe.ru/download/scaner/DBS_HC-3208SR.docx HC-3208SR (Подходите также к МSC-3208 WEC2D V.2)]
|-
|Winson
|[https://www.courierexe.ru/download/scaner/Winson_WNL_WNC_6003_6083.docx WNL/WNC 6003, 6083, 5083]
|-
|Global-pos
|[https://www.courierexe.ru/download/scaner/GP-9400B.docx Global-pos GP-9400B]
|-
|Mertech
|[https://courierexe.ru/download/scaner/Mertech_cl-2300.docx CL-2300]
|-
|Space
|[https://www.courierexe.ru/download/scaner/Space_x-2020rc.docx]
|-
|Bluetooth-кольцо
|[https://courierexe.ru/download/scaner/GP-1901B.docx GP-1901B]
|-
|Mindeo
|[https://www.courierexe.ru/download/scaner/mindeo_md6600.docx MD6600]
[https://www.courierexe.ru/download/scaner/Mindeo_cs2290_hd_bt.docx CS2290HD(BT)]
|-
|Holyhah a30d, Hstem a30d
|[https://courierexe.ru/download/scaner/holyhah_a30d_hstem_a30d.docx a30d]
|-
|Urovo R70 (71) сканер-кольцо
|[https://www.courierexe.ru/download/scaner/R70-71.docx R70(71)]
|-
|DATAMAX A-7710 B
|[https://www.courierexe.ru/download/scaner/DATAMAX_A-7710_B_2.docx A-7710 B] (если штрих-коды с листа плохо читаются, отсканируйте их же с приложенной к сканеру инструкции)
|}


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

'''Примечание 2'''. В некоторых моделях сканеров, особенно это касается DATAMAX, по умолчанию устанавливается неверная кодировка символов. Даже если вы правильно настроите сканер (установите префикс в виде знака тильды), при сканировании, на выходе такой сканер может отдавать совсем другой префикс (например, вместо ~ или Ё, будет /). Чтобы решить эту проблему, измените в настройках сканера местоположение или язык на English (или любой другой, где доступно ASC2 code keyboard input) путем считывания специального управляющего кода из инструкции к сканеру.

Cписок '''неподдерживаемого системой оборудования''':
* CT10 Barcode Scanner (Производитель CILICO Electronics Co., Ltd Китай);
* Аlanda 2.4G Barcode Scanner (производитель Китай).
* Birch bd — 388 iiib (производитель Китай);

Это оборудование не позволяет установить требуемый префикс для работы с MeaSoft. Список далеко не полный.

'''Мы рекомендуем покупать сканеры, официально ввезенные в Россию, адаптированные для российского рынка, имеющие здесь официальных поставщиков.'''

При выборе сканера обратите внимание на то, что при типе подключения USB HID (этот режим рекомендуется) или «разрыв клавиатуры» сканер требует некоторой настройки. В разделе описания выше приведены программирующие листы для различных моделей сканеров. Если вы покупаете сканер не из списка, для которого уже есть программирующий лист, будьте готовы к тому, что потребуется создание такого листа. Для его создания нужно полное руководство по программированию конкретного сканера на русском или английском языках. С наличием инструкции очень часто возникают проблемы, если вы покупаете сканеры с доставкой из Китая — они, как правило, настолько не адаптированы к работе, что у них нет ни документации, ни сайта производителя. В таком случае остается уповать только на везение.

Если ваш новый сканер не поддерживается нашей системой, можно попытаться выяснить, может ли он работать в режиме эмуляции COM-порта. Наличие возможности работы в таком режиме — последний шанс использовать купленное оборудование:
# Переведите сканер в режим USB virtual COM по инструкции.
# Установите бесплатные драйверы COM-порта Nuvoton.
# В MeaSoft программе выберите '''Настройка''' > '''Параметры''' > '''Оборудование''' > '''Использовать COM-сканер''', укажите номер виртуального COM-порта, созданного драйвером (см. в диспетчере устройств Windows).
Обратите внимание, что при переключении сканера в другой USB-порт может меняться номер COM-порта, и настройку программы нужно делать заново.

===Возможные проблемы при работе сканеров с маркировкой Честный Знак===

В некоторых сканерах по умолчанию может быть включена настройка, которая пытается компенсировать работу CapsLock, если тот включен, чтобы, например, в блокнот всегда печатался одинаковый код. Наша программа не учитывает CapsLock при сканировании и берет только те значения, которые передает сканер. Поэтому, при нажатом CapsLock может предаваться код маркировки с измененными регистрами букв, что затем будет мешать в работе с маркировкой. Чтобы этого избежать, нужно отключить опцию, компенсирующую работу CapsLock. Например, для сканера Sunlux XL-3200 данная настройка называется '''Caps Lock Off''': [[Файл:CapsOnScanner.png|none|700px]]

== Настройка весов ==

=== Общие сведения ===
MeaSoft поддерживает работу с различными видами весов. Весы могут подключаться через сетевой порт, COM- или USB-порт.

При подключении через USB установите на компьютер драйвер USB-COM конвертера. Драйвер поставляется производителем весов либо переходника, через который вы подключаете весы. После установки драйвера в «Диспетчере устройств» вашего компьютера должен появиться новый COM-порт, через который и будет осуществляться дальнейшее взаимодействие с весами. Обратите внимание: при подключении USB-шнура к другому USB-разъему компьютера может измениться номер COM-порта, который привязан к шнуру. В этом случае укажите в программе новый номер порта.

Чтобы начать использовать весы, подключите их к компьютеру, затем в пункте основного меню '''Настройка > '''Параметры''' > '''[[Настройка параметров рабочего места#Оборудование|Оборудование]]''' установите флажок '''Использовать весы''', выберите тип весов и укажите порт.

После успешного подключения весов откройте карточку корреспонденции (или окно «Прием» в заказах). Возле поля '''Масса''' появится кнопка весов. Чтобы программа показывала вес с весов, эта кнопка должна быть нажата.

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

=== Настройка весов МЕРА ===
Для связи с весами мера система использует протоколы «9байт», «ОКА» и «MERA-AUTO» и «Сетевые».

Какой выбрать:
* 9байт — установлен в весах по умолчанию. Он позволяет передавать нестабильный вес, что хорошо влияет на скорость работы оператора. Однако это протокол использует низкоуровневую работу с COM-портом, что может не поддерживаться USB-COM переходниками. Выбирайте этот протокол если весы подключены к настоящему, аппаратному COM-порту. Так же этот протокол, вероятно, единственный, который можно использовать в весах, у которых нет цифровой клавиатуры (см. ниже — без нее весы просто невозможно переключить на другой протокол);
* ОКА — во многих моделях весов не поддерживает передачу нестабильного веса, так что работать с ним — медленнее, чем возможно. Но этот протокол поддерживают все весы «МЕРА» с цифровой клавиатурой;
* MERA-AUTO — наиболее продвинутый, рекомендованный производителем протокол. Позволяет передавать нестабильный вес. Однако весы нужно на него переключать (см. ниже), также он поддерживается не всеми весами;
* Сетевые — для весов, подключающихся не к COM-порту, а непосредственно к локальной сети.

Выбор протокола в весах: воспользуйтесь выдержкой из их [http://courierexe.ru/download/scale/mera/MERA-VTP_VT-1A_2007.pdf руководства пользователя] или [http://courierexe.ru/download/scale/mera/servmanpvm2007.pdf другой версии руководства]:

9.1 Выбор протокола
9.1.1 Удерживая нажатой кнопку «5» клавиатуры терминала, кратковременным нажатием кнопки «[[Файл:PowerOn.png]]» включить весы.
Используя ту же клавиатуру набрать код 39654 и затем нажать клавишу ввода «[[Файл:Enter.png]]» или «T» (Тара).
При правильно выполненном действии будет активизирован режим настройки и на дисплее появится сообщение «_____9».
9.1.2 Последовательно нажать кнопки «1» и «4» и ввести кодовый номер требуемого протокола '' '''(для протокола "9байт" - «0», "ОКА" - «1», "MERA-AUTO" - «5»)''' '' из таблицы кодов нажатием одной из кнопок «0»…«9».
9.1.3 Нажатием кнопки «9» зафиксировать результат.

'''Обратите внимание''' на то, что в этой инструкции подразумевается наличие полной цифровой клавиатуры с кнопками «0».."9". Если у ваших весов такой клавиатуры нет — они не поддерживают изменение протокола, и переключить их не удастся.

В программе нажмите «Настройка» — «Параметры» — «Оборудование». Поставьте галку «Использовать весы», выберите протокол и порт весов. После настройки обязательно перезагрузите программу и весы.

Для проверки работоспособности подключения можно использовать официальную [http://courierexe.ru/download/scale/mera/Oka.exe программу МЕРА]. Обратите внимание, что эта программа не будет работать, если открыта программа MeaSoft с включенным использованием весов, и наоборот. В один момент времени к весам может подключаться только одна программа.

=== Настройка весов НЕВА ===
По нашему опыту работы с весами «НЕВА» складывается интересная ситуация: производитель заявляет, что все модели их весов работают по разным протоколам. Протокол зависит от модели «пульта» — такой штуки, с индикатором и кнопками. При этом по конкретной модели пульта они передали протокол, который не соответствует действительности. В итоге конкретные весы, имевшиеся в наличии, к программе подключены (методом [https://ru.wikipedia.org/wiki/Обратная_разработка обратного инжиниринга] протокола), в списке видов весов в настройке оборудования они присутствуют, но мы не можем дать никаких гарантий того, что конкретные весы, приобретенные вами, будут работать с программой. Мы не рекомендуем этот тип весов к приобретению, но если они у вас уже есть и система с ними не работает — звоните, будем думать, что с этим можно сделать.

=== Настройка весов МАССА-К ===
Для поддержки весов Масса-К в системе предусмотрена поддержка «Протокола № 2». Этот протокол по умолчанию включен в весовых терминалах [https://courierexe.ru/download/scale/massa/TB_A_r6.2_2017.pdf А/ТВ] и [https://courierexe.ru/download/scale/massa/TB_T_r3.2_2016.pdf Т/ТВ]

=== Настройка весов CAS ===

В программе поддерживаются весы CAS с протоколом AD. Известно, что протокол AD используется во всех моделях линейки HD, DB, но у него есть несколько версий. Чтобы весы начали передавать вес в программу, необходимо в настройках весов, через специальное меню настроек (описание есть в документации к весам), включить режим автоматической передачи данных по стабилизации.

Примеры настройки:
*Для весов CAS DB-1H в программе выберите ротокол '''CAS DB-H'''. В настройках весов обязательно включите режим '''Pr off'''. Скорость передачи 9600;
*Для весов CAS HD (300, 4050) в программе выберите протокол '''CAS HD''';

=== Настройка весов Mettler Toledo ===

Для поддержки весов TLX Mettler Toledo в программу добавлен протокол TLX Mettler Toledo (TCP/IP Client), весы настроены в качестве сервера, программа подключается к весам и обрабатывает сообщения с данными измерений. Поддерживается передача: штрих-кода, веса, длины , ширины, высоты.

Для поддержки весов CSN 810 Mettler Toledo в программу добавлен протокол CSN Mettler Toledo, оборудование имеет подключение к сканеру (CSN810) и весам (ICS425) по двум разным IP. Сканер настроен в качестве сервера, а весы необходимо опрашивать командой. Программа подключается по 2 IP записанным через запятую и обрабатывает сообщения с данными измерений. Поддерживается передача: веса, длины , ширины, высоты. Оборудование необходимо напрямую подключать к компьютеру по двум сетевым картам. Каждое сетевое подключение должно быть в одной сети с подключение от оборудования. Пример подключения сканера: IP сканера 192.168.127.14 порт 3001, сетевая карта должна иметь IP 192.168.127.2 маску 255.255.255.0 и основной шлюз 192.168.127.14. Пример подключения весов: IP 2.197.100.191 порт 3001, сетевая карта IP 2.197.100.2 маска 255.255.255.0

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

Настройка порядка цены деления весов доступна через главное меню '''Настройка''' > '''Параметры''' > '''Оборудование''', поле '''Порядок цены деления'''.

Доступные значения поля '''Порядок цены деления''':

'''0''' — 1 грамм;

'''1''' — 10 грамм;

'''2''' — 100 грамм.

Таким образом, если весы показывают в 10 раз меньше, чем на самом деле, установите '''Порядок цены деления''' равным 1.

== Настройка фискальных регистраторов ==
Все фискальные регистраторы должны вноситься в справочник '''[[Фирмы]]'''. Для корректной работы ФР необходимо регистрировать ее в налоговой с нужным признаком агента, а потом прописывать его в системе.

=== Стационарные Штрих-М ===

=== Облачные LIFE PAY ===

=== Облачные Webkassa ===

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

Закрытие смены происходит через ЛК WebKassa

== Мобильные устройства курьеров ==
Процесс выбора оборудования, установки и настройки приложения для мобильного устройства курьера подробно рассмотрен в статьях «[[Мобильное приложение курьера для Android]]» и «[[Мобильное приложение курьера для IPhone]]».

== Подключение принтера по Wi-Fi ==

=== Печать через WSD ===

В случаях, когда печать через WSD недоступна, драйвер не поддерживает стандартные функции печати.
Причина: WSD-порт не всегда корректно работает с потоковой печатью GDI.
Рекомендации:
Измените тип порта с WSD на TCP/IP.
1) Откройте Панель управления → Устройства и принтеры.
2) ПКМ на принтер → Свойства принтера → Порты.
3) Нажмите Добавить порт → Стандартный TCP/IP-порт.
4) Укажите IP-адрес принтера
5) Выберите Тип устройства → Generic Network Card.
После создания порта — выберите его вместо WSD и примените. После этого WSD-порт можно удалить.
Если принтер использует универсальный драйвер Windows (WSD), попробуйте установить PCL или PS драйвер от производителя вручную, указав IP-адрес.

Оборудование

2026-03-12T15:40:33Z

Sammy: /* Настройка весов Mettler Toledo */

== Аппаратные требования к рабочей станции ==
* Работа под управлением ОС Windows 32/64 Bit: Win7, Win8; Win10; Win11.
* Установленный и активированный пакет Microsoft Office 2007 или выше '''кроме «Office 2010 Starter»'''.
* Процессор: любой, удовлетворяющий рабочим требованиям линейки ОС Windows.
* Оперативное запоминающее устройство (ОЗУ): от 2 Gb и выше.
* Запоминающее устройство HDD или SSD: от 60 GB и выше.
* Сетевой интерфейс: проводной/беспроводной Ethernet интерфейс.
* Монитор: диагональ, обеспечивающая разрешающую способность экрана не менее 1024*768 пикселей.
* Периферийные порты ввода-вывода USB, RS232 (при необходимости наличия таковых): для подключения периферийного оборудования (сканер штрихкодов, фискальный регистратор, термопринтер).
* Клавиатура, манипулятор мышь.

== Выбор сервера для системы ==

=== Выбор серверного оборудования ===
Система MeaSoft нетребовательна к аппаратным ресурсам сервера.

Что касается '''производительности''', то для небольшой компании, человек 10 в офисе, как правило, производительности бытового ноутбука, установленного в качестве сервера, будет более, чем достаточно. То есть серверную часть можно установить на любую машину, за которой работает пользователь. Для компаний до 20 сотрудников мы рекомендуем использовать бытовой компьютер, но «назначенный» сервером, то есть чтобы он стоял отдельно работал круглосуточно, и им никто не пользовался в качестве рабочей станции. Для компаний более 20 человек — лучше использовать именно серверное оборудование, хотя у нас есть установка, где на бытовом Core i3 одновременно работает 80 человек.

'''Объем диска''': Изначально при установке БД занимает около 1 Gb. Далее она увеличивается в зависимости от использования. Если компания доставляет 20000 отправлений в месяц, через 3 года объем базы будет 10 Gb с одной оговоркой: Больше всего места в БД занимают файлы, такие, как архив отсканированных накладных, отправленные по почте отчеты и счета, и т. д. Здесь, если компания использует эти возможности, она за год может накопить и 100 и 200 Gb. Так же необходимо учитывать некоторый объем свободного места, необходимый для создания резервных копий, а так же для работы самой ОС.

Самое главное требование системы к серверу — это его '''надежность'''. Надо понимать, что при поломке сервера приостановится работа всей компании. В худшем случае — можно потерять данные, введенные с момента последней резервной копии. Для сокращения возможных рисков, нужно стараться, по возможности, делать сервер максимально надежным:

* Мы не рекомендуем устанавливать сервер на ноутбук, так как его форм-фактор предполагает некоторую степень мобильности. Есть соблазн взять его куда-то с собой. А при перемещении велик риск его потери, кражи, его можно уронить и разбить. Еще один фактор низкой надежности ноутбуков — они часто умирают от пролитого на них чая/кофе/пива.
* Мы не рекомендуем устанавливать серверную часть на компьютер, за которым работает пользователь. Здесь главный фактор риска — это заражение компьютера вирусами, которые пользователь, по неграмотности, скачивает из интернета, приносит на флешках и т. д. Антивирус никакой от этого не спасает.
* Мы рекомендуем устанавливать на серверный компьютер [https://ru.wikipedia.org/wiki/RAID Raid-1] массивы для снижения вероятности выхода из строя/потери данных в случае поломки жесткого диска. Однако нужно понимать, что это тоже не панацея: жесткие диски достаточно часто выходят из строя все одновременно, например, при поломке блока питания, когда напряжение «пробивает» через него и приводит к выгоранию всех компонентов компьютера, В случае стихийных бедствий и несчастных случаев (прорывы в трубах, например), или просто от того, что 2 HDD одной модели, купленные одновременно имеют одинаковый ресурс наработки на отказ.
* Мы рекомендуем устанавливать [https://ru.wikipedia.org/wiki/Источник_бесперебойного_питания ИБП] на сервер для предохранения его от скачков напряжения в сети и/или аварийного завершения работы при отключении питания.
* Мы рекомендуем использовать специализированное серверное оборудование, так как оно по определению гораздо надежнее, вплоть до резервирования блоков питания. Но такое оборудование достаточно дорогое, и его использование носит исключительно рекомендательный характер.

Некоторые наши клиенты не удовлетворяются вышеизложенными рекомендациями по выбору серверного оборудования и просят нас предоставить формальные требования к серверу. Вот они:

1. Работа под управлением ОС Windows 2012 Server R2; 
2. Процессор: многоядерный, удовлетворяющий требованиям ОС; 
3. Оперативное запоминающее устройство (ОЗУ): от 4 GB; 
4. Запоминающее устройство HDD: от 360 Gb, Raid-1; 
5. Сетевой интерфейс: проводной Ethernet интерфейс — 100 Mbit.; 
6. Монитор, с разрешением минимум 1024*768; 
7. Клавиатура microsoft минимум 103 клавиши; 
8. Мышь оптическая; 
9. Колонки активные минимум 2 Вт; 
10. Коврик для мыши силиконовый :-) 

=== Выбор серверной операционной системы ===
Серверная часть MeaSoft работает практически на любой операционной системе. Исключение — модуль интеграции с внешними системами.

При выборе ОС нужно рассмотреть все плюсы и минусы. Обычно выбор стоит между Windows и Linux.

Windows — платная система. Серверная Windows стоит 40-45 т.р. Система прекрасно работает, например, на Windows 7 (желательно только не домашнюю версию), которая стоит в разы меньше. Ограничение на количество подключений к ней не имеет отношения к нашей системе.

Linux — «бесплатная» система. Почему в кавычках? Потому что стоимость владения им гораздо выше: для администрирования системы linux необходим системный администратор с глубокими познаниями этой ОС, а такие специалисты стоят в 2 раза дороже, чем администраторы Windows.

Таким образом даже «дорогая» серверная Windows окупается за пару месяцев. Linux можно выбирать только в том случае, если в вашей компании и так уже работает несколько системных администраторов Linux, которые смогут решать возможные проблемы с ней. Наша компания оказывает необходимую для работы системы помощь в администрировании windows-серверов, но с linux эта функция полностью ложится на заказчика. Почему мы говорим, что должно быть несколько администраторов в случае с Linux? Потому что в случае увольнения единственного администратора, как правило, компанию ждут времена несчастий, пока не найдется новый ТОЛКОВЫЙ системный администратор.

Резюме: Выбирайте Linux только в том случае, если вы точно уверены в том, что делаете. В противном случае — только Windows.

=== Размещение сервера ===
Для классической архитектуры системы, когда офис-склад консолидированы в одном месте, мы рекомендуем размещение сервера в офисе. То есть в точке максимального использования системы. Это обеспечивает максимальную скорость и надежность. При этом при необходимости удаленного доступа к системе — достаточно, имея внешний статичный IP-адрес, «пробросить» порт 3306 на сервер.

В последнее время все больше популярность приобретает размещение сервера «в облаке». На самом деле формально — это, конечно, не [https://ru.wikipedia.org/wiki/Облачное_хранилище_данных облако] в широком понимании, а [https://ru.wikipedia.org/wiki/VPS сервер], физический или виртуальный, находящийся в дата-центре. При выборе такого варианта установки программы следует учесть ряд факторов:
* '''Скорость доступа''' Наша система очень чувствительна к скорости доступа. Некоторые операции могут вызывать несколько обращений к серверу, и увеличение времени одного обращения на несколько миллисекунд существенно снижает общую производительность системы на рабочем месте. При размещении сервера в дата-центрах Европы, например, скорость доступа ([https://ru.wikipedia.org/wiki/Ping ping]) из Москвы составляет 50-60 мс. Это — на грани возможности использования программы. При размещении в дата-центре того же города, где находятся пользователи, время доступа — порядка 3-5 мс. Для сравнения — доступ по локальной сети — менее 1 мс.
* '''Надежность интернет-канала''' Нужно понимать, что в случае размещения сервера в интернете система не будет работать у вас в офисе и/или на складе в случае отсутствия доступа в интернет. Желательно обеспечить резервирование канала, причем, желательно, не 3G-«свистком» (см. следующие 2 пункта).
* '''Пропускная способность интернет-канала''' При разработке системы мы стараемся минимизировать объемы информации, передаваемые между рабочим местом и сервером. Но если доступ происходит через интернет, на одном канале работает несколько человек, на котором работает и программа и телефоны, а кто-то смотрит видео в ютубе, а кто-нибудь еще придумает пользоваться торрентами — работа остановится.
* '''Стабильность интернет-канала''' При доступе к серверу не должны теряться пакеты. Если на канале происходят потери — программа будет закрываться с сообщением о том, что произошла потеря соединения с сервером. Потери пакетов можно проанализировать командой ping -t <имя_сервера, например ya.ru>.
* '''Надежность дата-центра''' Теоретически — в дата-центре обеспечивается резервирование и электропитания, и каналов передачи данных. Естественно, в них стоят и промышленные климатические системы, поддерживающие заданную рабочую температуру всего оборудования. Но на практике часто бывает, что сервер оказывается недоступным на время от нескольких минут до нескольких дней. Техподдержка (если ее телефон вообще отвечает, а часто как раз в эти моменты она не работает — либо потому, что телефония работает на том же канале, который у них и «упал», либо потому, что тысячи пользователей серверов, обнаружив неполадки, начали им одновременно звонить) скажет «да, в вашем сегменте технические неполадки, мы устраняем», и больше сделать вы ничего не сможете. В случае, если сервер стоит у вас в офисе — вы сами принимаете моментальные меры. Вплоть до того, что можно вынуть из сгоревшего сервера жесткий диск, подключить к другому компьютеру, и восстановить работу системы.
* '''Стоимость''' При размещении на linux-VDS серверах стоимость на текущий момент — [http://firstvds.ru/products/vds_vps_hosting 600-900 руб/мес], Windows — [https://masterhost.ru/service/hosting/vps/ 4000 руб/мес]. По поводу выбора ОС читайте соответствующий раздел этой же статьи.

Отсюда вывод:
Мы рекомендуем устанавливать сервер «в облаке» только в случае сильно распределенной структуры компании. Когда максимальную скорость и надежность нужно обеспечить множеству удаленных пользователей, а не в одном конкретном месте.

== Доступ для установки системы ==

Для установки системы программисту MeaSoft требуется доступ к вашему серверу с правами администратора. В процессе установки потребуется устанавливать службы, запускать и останавливать их, а также производить запуск приложений от имени администратора. Доступ можно предоставить одним из способов:
* по [https://remontka.pro/microsoft-remote-desktop/ RDP] — передайте нам IP-адрес сервера, порт (если он отличается от стандартного), логин и пароль для подключения;
* через [https://www.teamviewer.com/ru/info/remote-desktop/ TeamViewer] — установите и запустите программу на сервере и передайте нам ID и пароль подключения.

== Рекомендованное периферийное оборудование ==

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

Мы рекомендуем:
* Zebex Z-3000 (CCD-сканер) — дешевый;
* Honeywell (Metrologic) 5145 Eclipse — лазерный;
* Honeywell (Metrologic) DS6707 — image, позволяет сканировать 2D-штрихкоды;
* Honeywell (Metrologic) 1202g Voyager BT — радиосканер, позволяет сканировать на расстоянии от компьютера.

Рекомендуются к приобретению сканеры с типом подключения USB HID.

Вы можете скачать наше бесплатное мобильное приложение [[Кладовщик — мобильное приложение для Android|Кладовщик]], которое работает как сканер штрихкодов.

Если вы определились с моделью сканера, то тип подключения не играет существенной роли: наша программа позволяет работать с любой из списка поддерживаемых моделей (проводной или беспроводной). Выбор интерфейса, скорее всего, зависит от наличия и доступности соответствующего порта на компьютере пользователя (так, интерфейс RS-232 предполагает наличие COM-порта, а интерфейс KBW, как правило, PS/2). Очевидным является тот факт, что наиболее универсальным будет сканер, работающий через интерфейс USB (USB HID).

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

При выборе сканера обратите внимание на то, что при типе подключения USB HID (рекомендуется) или «разрыв клавиатуры» сканер требует некоторой настройки. [[#Подключение и настройка сканеров штрихкодов|В разделе ниже]] приведены программирующие листы для различных моделей сканеров. Если вы покупаете сканер не из списка, для которого есть программирующий лист, будьте готовы к тому, что потребуется создание такого листа. Для его создания нужно полное руководство по программированию конкретного сканера на русском или английском языках. С этим часто бывают проблемы, если вы покупаете сканеры с доставкой из Китая — они, как правило, настолько китайские, что у них нет ни документации, ни сайта производителя. В таком случае остается уповать только на везение.

=== Термопринтер ===
Поддерживаются любые термо- и термо-трансферные принтеры. 
Рекомендуется термопринтер Zebra ZD410 — у него ширина печатающей головки 60 мм, поэтому ленту такой же ширины сложно вставить неправильно. Очень прост в обслуживании и заправке ленты. 
'''ВНИМАНИЕ!''' При покупке следует учитывать, что термопринтеры не комплектуются USB-шнуром и этикетками, поэтому их необходимо приобрести отдельно. Рекомендуем этикетки размером 58×40 мм.

=== Весы ===
Поддерживаемые весы:
* [[#Настройка весов МЕРА|МЕРА]] — подходят модели, которые поддерживают протоколы «ОКА», «9 байт» или «Mera Avto». По нашим сведениям, протоколы ОКА и Mera Avto поддерживают весы, у которых есть цифровая клавиатура 0-9. Но лучше уточняйте у продавца. Протокол «9 байт» в силу своей низкоуровневой работы с COM-портом может не работать через USB-переходники. Рекомендуем весы Мера ВП-3/30 — небольшие, точные, недорогие. 
* [[#Настройка весов НЕВА|Нева]]
* ExpressCube
* Масса-К
* InSize
* Мастер-Кит
* CAS HD 57583
* UIS Metrix

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

Инструкцию по настройке и подключению весов смотрите в этой статье [[#Настройка весов|ниже]].

=== Фискальный регистратор ===
В рамках 54-ФЗ поддерживается и рекомендуется работа с сервисом удаленной фискализации LIFE PAY.

Поддерживаются все фискальные регистраторы фирмы «Штрих-М»

Рекомендуется ШТРИХ-LIGHT-ФР-К (cамый бюджетный)

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

=== Банковский POS-терминал ===
[https://ru.wikipedia.org/wiki/POS-%D1%82%D0%B5%D1%80%D0%BC%D0%B8%D0%BD%D0%B0%D0%BB POS-терминал].
Мобильное приложение поддерживает интеграцию с сервисами IBox, LIFE PAY, а также поддерживается работа с независимыми POS-терминалами.

=== Планшетный сканер ===
Применяется для сканирования ведомостей с подписью, после чего полученные документы вы можете прикрепить в программе к соответствующей корреспонденции. 
Рекомендуются сканеры с автоматической подачей. 
При выборе устройства обратите внимание на следующие характеристики:
* Скорость сканирования;
* Наличие функции обнаружения подачи двух листов;
* Двухстороннее сканирование;
* Количество сканирований до отказа.

=== Монитор ноутбука/нетбука/компьютера ===
Рабочее место пользователя для работы с MeaSoft должно оснащаться монитором с разрешающей способностью экрана не менее 1024*768 пикселей. При работе на портативных устройствах, таких как нетбуки, у которых разрешение ниже рекомендуемого, в экран могут не помещаться некоторые окна.

=== Штрихкодовая линейка-угол ===
Штрихкодовая линейка-угол применяется для обмера габаритов отправления. Обмер можно производить при приеме корреспонденции на склад (F10 на вкладке «Заказы»). Каждое деление (1, 5 или 10 миллиметров) линейки промаркировано своим штрихкодом. Прикладывая товар к линейке и сканируя штрихкод, соответствующий краю товара, получаем размеры. Чтобы включить поддержку штрихкодированной линейки, нужно в окне приема, нажать кнопку «Настройки» и установить галку «Включить поддержку штрихкодированной линейки». Для работы с линейкой удобнее использовать лазерные сканеры, у них полоса считывания наводится точно на нужный штрихкод. Реализована поддержка производителя [http://cortes.ru/shtrihcode/barcodeline.php Кортес]. Перед покупкой нужно проверять модель на совместимость с системой. Система поддерживает следующий формат ШК: 
Длина ШК 7 символов, начинается всегда на «29», например: 291XXXX, 292XXXX, 293XXXX 
где: XXXX — значение в милиметрах, 3-й знак — направление измерения от 1 до 3, то есть координата (длина, ширина, высота).

=== Терминал сбора данных ===
Терминал сбора данных (ТСД) под управлением Android может работать совместно с MeaSoft как сканер штрихкодов или ТСД. Для этого установите на ТСД наше приложение [[Мобильное приложение кладовщика для Android|Кладовщик]] и выберите нужный режим работы.

== Подключение и настройка сканеров штрихкодов ==
MeaSoft поддерживает все виды [http://ru.wikipedia.org/wiki/Сканер_штрихкода сканеров штрихкодов], поэтому при выборе сканера следует учитывать особенности штрихкодов, которыми заказчики маркируют корреспонденцию. В частности, контактные светодиодные сканеры можно использовать для считывания штрихкодов длиной не более 5-7 см (в зависимости от модели сканера), а для двухмерных штрихкодов необходим image-сканер.

При подключении в разрыв клавиатуры или в порт USB в режиме эмуляции разрыва клавиатуры требуется небольшая дополнительная настройка сканера. Для этого существуют специальные программирующие листы (см. ниже) для разных моделей сканеров, на которых напечатаны штрихкоды в определенной последовательности. Просканируйте их в том порядке, в котором они расположены на листе. Как правило, для сканеров одной фирмы подходят одни и те же штрихкоды.
В результате этих действий при каждом сканировании перед штрихкодом вставляется определенный префикс, наличие которого для программы является признаком того, что данная последовательность символов введена с помощью сканера. Для использования в качестве префикса в программе зарезервирована клавиша с буквой «ё», что накладывает некоторое ограничение: невозможно ввести с клавиатуры символы «ё», «Ё», «`», «~».

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

{| class="wikitable" style="width: 60%
!style="width: 30%;"|Бренд
!style="width: 70%;"|Модель
|-
|Argox
|[https://www.courierexe.ru/download/scaner/Argox.doc ArgoScan 8000/8110/8120/8150/8250/8310/8312, argox as-8020cl (usb))]
|-
|Champtek
|[https://www.courierexe.ru/download/scaner/Champtek.doc Champtek]
|-
|Cino
|[https://www.courierexe.ru/download/scaner/Cino.doc F680BT]
|-
|Cipherlab
|[https://www.courierexe.ru/download/scaner/Cipherlab_1021_(simple).doc 1021 (simple)] [https://www.courierexe.ru/download/scaner/Cipherlab_1021_(simple)_and_back.doc 1021 с переключением обратно] [https://www.courierexe.ru/download/scaner/Cipherlab_1560,_1562,_1070_(bluetooth).doc 1560, 1562, 1070 (bluetooth)]
|-
|Metrologic/Eclipse/Honeywell/Motorola/Symbol/Youjie
|[https://www.courierexe.ru/download/scaner/Honeywell_Xenon_1900.doc Xenon 1900, Voyager 1202g, YJ4600] [https://www.courierexe.ru/download/scaner/Metrologic,_Eclipse,_Honeywell,_ms9520,_ms9540.doc MS5145, MS9520, MS9540, HH440] [https://www.courierexe.ru/download/scaner/Symbol_ls1203,_LS2208.doc LS1203, LS2208] (подходит для li4278, Zebra DS2278) [https://www.courierexe.ru/download/scaner/Symbol_ds6707.doc DS6707] [https://www.courierexe.ru/download/scaner/honeywell_1452g.docx Honeywell Voyager 1452G] [https://www.courierexe.ru/download/scaner/honeywell_1472g.docx Honeywell 1472g]
|-
|PayTor
|[https://www.courierexe.ru/download/scaner/Paytor%20DS%201009.docx DS 1009]
|-
|Proton
|[https://www.courierexe.ru/download/scaner/Proton.doc Proton]
[https://www.courierexe.ru/download/scaner/Proton_2.doc IMS3190, беспроводной)]
|-
|Datalogic
|[https://www.courierexe.ru/download/scaner/PSC,_Datalogic_QS2500.doc PSC, Datalogic QS2500] [https://www.courierexe.ru/download/scaner/qd2100.doc QD2100] 
[https://www.courierexe.ru/download/scaner/datalogic800i.docx Magellan 800i] 
[https://www.courierexe.ru/download/scaner/QuickScanMobile.doc Mobile: QM2100, M2]
|-
|Scanport
|[https://www.courierexe.ru/download/scaner/Scanport_T600.bmp T600]
|-
|Zebex
|[https://www.courierexe.ru/download/scaner/Zebex_4.bmp Zebex]
|-
|Godex
|[https://www.courierexe.ru/download/scaner/godex.doc GS550U]
|-
|Mercury
|[https://www.courierexe.ru/download/scaner/mercury.doc CL-200] [https://www.courierexe.ru/download/scaner/Mercury_1100PL.docx 1100PL]
|-
|Если у вас китайский безымянный (беспроводной?) сканер, попробуйте этот лист
|[https://www.courierexe.ru/download/scaner/Vioteh.doc Vioteh VT2208R, Dudian CT980N, bp8150s, Heroje B120G]
|-
|Vioteh
|[https://www.courierexe.ru/download/scaner/VT2205_VT2209.docx VT2205 VT2209]
|-
|Heroje
|[https://www.courierexe.ru/download/scaner/Heroje_H018.doc H018]
|-
|Производитель Китай под российским брендом АТОЛ. 
Cканер не рекомендуется к покупке. Атол выпускает несколько разных версий сканера под одной моделью SB1101. К сожалению, не все модели поддаются настройке.
|[https://www.courierexe.ru/download/scaner/Atol_SB_1101.docx SB 1101] [https://www.courierexe.ru/download/scaner/Atol_SB_1103.docx 1103]
|-
|Radall
|[https://www.courierexe.ru/download/scaner/Radall_RD-h8_2d.docx RD-h8 2d]
|-
|NETUM
|[https://www.courierexe.ru/download/scaner/NETUM_W6.docx W6, C750]
|-
|DBS
|[https://www.courierexe.ru/download/scaner/DBS_HC-3208SR.docx HC-3208SR (Подходите также к МSC-3208 WEC2D V.2)]
|-
|Winson
|[https://www.courierexe.ru/download/scaner/Winson_WNL_WNC_6003_6083.docx WNL/WNC 6003, 6083, 5083]
|-
|Global-pos
|[https://www.courierexe.ru/download/scaner/GP-9400B.docx Global-pos GP-9400B]
|-
|Mertech
|[https://courierexe.ru/download/scaner/Mertech_cl-2300.docx CL-2300]
|-
|Space
|[https://www.courierexe.ru/download/scaner/Space_x-2020rc.docx]
|-
|Bluetooth-кольцо
|[https://courierexe.ru/download/scaner/GP-1901B.docx GP-1901B]
|-
|Mindeo
|[https://www.courierexe.ru/download/scaner/mindeo_md6600.docx MD6600]
[https://www.courierexe.ru/download/scaner/Mindeo_cs2290_hd_bt.docx CS2290HD(BT)]
|-
|Holyhah a30d, Hstem a30d
|[https://courierexe.ru/download/scaner/holyhah_a30d_hstem_a30d.docx a30d]
|-
|Urovo R70 (71) сканер-кольцо
|[https://www.courierexe.ru/download/scaner/R70-71.docx R70(71)]
|-
|DATAMAX A-7710 B
|[https://www.courierexe.ru/download/scaner/DATAMAX_A-7710_B_2.docx A-7710 B] (если штрих-коды с листа плохо читаются, отсканируйте их же с приложенной к сканеру инструкции)
|}


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

'''Примечание 2'''. В некоторых моделях сканеров, особенно это касается DATAMAX, по умолчанию устанавливается неверная кодировка символов. Даже если вы правильно настроите сканер (установите префикс в виде знака тильды), при сканировании, на выходе такой сканер может отдавать совсем другой префикс (например, вместо ~ или Ё, будет /). Чтобы решить эту проблему, измените в настройках сканера местоположение или язык на English (или любой другой, где доступно ASC2 code keyboard input) путем считывания специального управляющего кода из инструкции к сканеру.

Cписок '''неподдерживаемого системой оборудования''':
* CT10 Barcode Scanner (Производитель CILICO Electronics Co., Ltd Китай);
* Аlanda 2.4G Barcode Scanner (производитель Китай).
* Birch bd — 388 iiib (производитель Китай);

Это оборудование не позволяет установить требуемый префикс для работы с MeaSoft. Список далеко не полный.

'''Мы рекомендуем покупать сканеры, официально ввезенные в Россию, адаптированные для российского рынка, имеющие здесь официальных поставщиков.'''

При выборе сканера обратите внимание на то, что при типе подключения USB HID (этот режим рекомендуется) или «разрыв клавиатуры» сканер требует некоторой настройки. В разделе описания выше приведены программирующие листы для различных моделей сканеров. Если вы покупаете сканер не из списка, для которого уже есть программирующий лист, будьте готовы к тому, что потребуется создание такого листа. Для его создания нужно полное руководство по программированию конкретного сканера на русском или английском языках. С наличием инструкции очень часто возникают проблемы, если вы покупаете сканеры с доставкой из Китая — они, как правило, настолько не адаптированы к работе, что у них нет ни документации, ни сайта производителя. В таком случае остается уповать только на везение.

Если ваш новый сканер не поддерживается нашей системой, можно попытаться выяснить, может ли он работать в режиме эмуляции COM-порта. Наличие возможности работы в таком режиме — последний шанс использовать купленное оборудование:
# Переведите сканер в режим USB virtual COM по инструкции.
# Установите бесплатные драйверы COM-порта Nuvoton.
# В MeaSoft программе выберите '''Настройка''' > '''Параметры''' > '''Оборудование''' > '''Использовать COM-сканер''', укажите номер виртуального COM-порта, созданного драйвером (см. в диспетчере устройств Windows).
Обратите внимание, что при переключении сканера в другой USB-порт может меняться номер COM-порта, и настройку программы нужно делать заново.

===Возможные проблемы при работе сканеров с маркировкой Честный Знак===

В некоторых сканерах по умолчанию может быть включена настройка, которая пытается компенсировать работу CapsLock, если тот включен, чтобы, например, в блокнот всегда печатался одинаковый код. Наша программа не учитывает CapsLock при сканировании и берет только те значения, которые передает сканер. Поэтому, при нажатом CapsLock может предаваться код маркировки с измененными регистрами букв, что затем будет мешать в работе с маркировкой. Чтобы этого избежать, нужно отключить опцию, компенсирующую работу CapsLock. Например, для сканера Sunlux XL-3200 данная настройка называется '''Caps Lock Off''': [[Файл:CapsOnScanner.png|none|700px]]

== Настройка весов ==

=== Общие сведения ===
MeaSoft поддерживает работу с различными видами весов. Весы могут подключаться через сетевой порт, COM- или USB-порт.

При подключении через USB установите на компьютер драйвер USB-COM конвертера. Драйвер поставляется производителем весов либо переходника, через который вы подключаете весы. После установки драйвера в «Диспетчере устройств» вашего компьютера должен появиться новый COM-порт, через который и будет осуществляться дальнейшее взаимодействие с весами. Обратите внимание: при подключении USB-шнура к другому USB-разъему компьютера может измениться номер COM-порта, который привязан к шнуру. В этом случае укажите в программе новый номер порта.

Чтобы начать использовать весы, подключите их к компьютеру, затем в пункте основного меню '''Настройка > '''Параметры''' > '''[[Настройка параметров рабочего места#Оборудование|Оборудование]]''' установите флажок '''Использовать весы''', выберите тип весов и укажите порт.

После успешного подключения весов откройте карточку корреспонденции (или окно «Прием» в заказах). Возле поля '''Масса''' появится кнопка весов. Чтобы программа показывала вес с весов, эта кнопка должна быть нажата.

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

=== Настройка весов МЕРА ===
Для связи с весами мера система использует протоколы «9байт», «ОКА» и «MERA-AUTO» и «Сетевые».

Какой выбрать:
* 9байт — установлен в весах по умолчанию. Он позволяет передавать нестабильный вес, что хорошо влияет на скорость работы оператора. Однако это протокол использует низкоуровневую работу с COM-портом, что может не поддерживаться USB-COM переходниками. Выбирайте этот протокол если весы подключены к настоящему, аппаратному COM-порту. Так же этот протокол, вероятно, единственный, который можно использовать в весах, у которых нет цифровой клавиатуры (см. ниже — без нее весы просто невозможно переключить на другой протокол);
* ОКА — во многих моделях весов не поддерживает передачу нестабильного веса, так что работать с ним — медленнее, чем возможно. Но этот протокол поддерживают все весы «МЕРА» с цифровой клавиатурой;
* MERA-AUTO — наиболее продвинутый, рекомендованный производителем протокол. Позволяет передавать нестабильный вес. Однако весы нужно на него переключать (см. ниже), также он поддерживается не всеми весами;
* Сетевые — для весов, подключающихся не к COM-порту, а непосредственно к локальной сети.

Выбор протокола в весах: воспользуйтесь выдержкой из их [http://courierexe.ru/download/scale/mera/MERA-VTP_VT-1A_2007.pdf руководства пользователя] или [http://courierexe.ru/download/scale/mera/servmanpvm2007.pdf другой версии руководства]:

9.1 Выбор протокола
9.1.1 Удерживая нажатой кнопку «5» клавиатуры терминала, кратковременным нажатием кнопки «[[Файл:PowerOn.png]]» включить весы.
Используя ту же клавиатуру набрать код 39654 и затем нажать клавишу ввода «[[Файл:Enter.png]]» или «T» (Тара).
При правильно выполненном действии будет активизирован режим настройки и на дисплее появится сообщение «_____9».
9.1.2 Последовательно нажать кнопки «1» и «4» и ввести кодовый номер требуемого протокола '' '''(для протокола "9байт" - «0», "ОКА" - «1», "MERA-AUTO" - «5»)''' '' из таблицы кодов нажатием одной из кнопок «0»…«9».
9.1.3 Нажатием кнопки «9» зафиксировать результат.

'''Обратите внимание''' на то, что в этой инструкции подразумевается наличие полной цифровой клавиатуры с кнопками «0».."9". Если у ваших весов такой клавиатуры нет — они не поддерживают изменение протокола, и переключить их не удастся.

В программе нажмите «Настройка» — «Параметры» — «Оборудование». Поставьте галку «Использовать весы», выберите протокол и порт весов. После настройки обязательно перезагрузите программу и весы.

Для проверки работоспособности подключения можно использовать официальную [http://courierexe.ru/download/scale/mera/Oka.exe программу МЕРА]. Обратите внимание, что эта программа не будет работать, если открыта программа MeaSoft с включенным использованием весов, и наоборот. В один момент времени к весам может подключаться только одна программа.

=== Настройка весов НЕВА ===
По нашему опыту работы с весами «НЕВА» складывается интересная ситуация: производитель заявляет, что все модели их весов работают по разным протоколам. Протокол зависит от модели «пульта» — такой штуки, с индикатором и кнопками. При этом по конкретной модели пульта они передали протокол, который не соответствует действительности. В итоге конкретные весы, имевшиеся в наличии, к программе подключены (методом [https://ru.wikipedia.org/wiki/Обратная_разработка обратного инжиниринга] протокола), в списке видов весов в настройке оборудования они присутствуют, но мы не можем дать никаких гарантий того, что конкретные весы, приобретенные вами, будут работать с программой. Мы не рекомендуем этот тип весов к приобретению, но если они у вас уже есть и система с ними не работает — звоните, будем думать, что с этим можно сделать.

=== Настройка весов МАССА-К ===
Для поддержки весов Масса-К в системе предусмотрена поддержка «Протокола № 2». Этот протокол по умолчанию включен в весовых терминалах [https://courierexe.ru/download/scale/massa/TB_A_r6.2_2017.pdf А/ТВ] и [https://courierexe.ru/download/scale/massa/TB_T_r3.2_2016.pdf Т/ТВ]

=== Настройка весов CAS ===

В программе поддерживаются весы CAS с протоколом AD. Известно, что протокол AD используется во всех моделях линейки HD, DB, но у него есть несколько версий. Чтобы весы начали передавать вес в программу, необходимо в настройках весов, через специальное меню настроек (описание есть в документации к весам), включить режим автоматической передачи данных по стабилизации.

Примеры настройки:
*Для весов CAS DB-1H в программе выберите ротокол '''CAS DB-H'''. В настройках весов обязательно включите режим '''Pr off'''. Скорость передачи 9600;
*Для весов CAS HD (300, 4050) в программе выберите протокол '''CAS HD''';

=== Настройка весов Mettler Toledo ===

Для поддержки весов TLX Mettler Toledo в программу добавлен протокол TLX Mettler Toledo (TCP/IP Client), весы настроены в качестве сервера, программа подключается к весам и обрабатывает сообщения с данными измерений. Поддерживается передача: штрих-кода, веса, длины , ширины, высоты.

Для поддержки весов CSN 810 Mettler Toledo в программу добавлен протокол CSN Mettler Toledo, оборудование имеет подключение к сканеру (напрямую к CSN810 без модуля интегарции VGA Display) и весам (ICS425) по двум разным IP. Сканер настроен в качестве сервера, а весы необходимо опрашивать командой. Программа подключается по 2 IP записанным через запятую и обрабатывает сообщения с данными измерений. Поддерживается передача: веса, длины , ширины, высоты. Оборудование необходимо напрямую подключать к компьютеру по двум сетевым картам. Каждое сетевое подключение должно быть в одной сети с подключение от оборудования. Пример подключения сканера: IP сканера 192.168.127.14 порт 3001, сетевая карта должна иметь IP 192.168.127.2 маску 255.255.255.0 и основной шлюз 192.168.127.14. Пример подключения весов: IP 2.197.100.191 порт 3001, сетевая карта IP 2.197.100.2 маска 255.255.255.0

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

Настройка порядка цены деления весов доступна через главное меню '''Настройка''' > '''Параметры''' > '''Оборудование''', поле '''Порядок цены деления'''.

Доступные значения поля '''Порядок цены деления''':

'''0''' — 1 грамм;

'''1''' — 10 грамм;

'''2''' — 100 грамм.

Таким образом, если весы показывают в 10 раз меньше, чем на самом деле, установите '''Порядок цены деления''' равным 1.

== Настройка фискальных регистраторов ==
Все фискальные регистраторы должны вноситься в справочник '''[[Фирмы]]'''. Для корректной работы ФР необходимо регистрировать ее в налоговой с нужным признаком агента, а потом прописывать его в системе.

=== Стационарные Штрих-М ===

=== Облачные LIFE PAY ===

=== Облачные Webkassa ===

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

Закрытие смены происходит через ЛК WebKassa

== Мобильные устройства курьеров ==
Процесс выбора оборудования, установки и настройки приложения для мобильного устройства курьера подробно рассмотрен в статьях «[[Мобильное приложение курьера для Android]]» и «[[Мобильное приложение курьера для IPhone]]».

== Подключение принтера по Wi-Fi ==

=== Печать через WSD ===

В случаях, когда печать через WSD недоступна, драйвер не поддерживает стандартные функции печати.
Причина: WSD-порт не всегда корректно работает с потоковой печатью GDI.
Рекомендации:
Измените тип порта с WSD на TCP/IP.
1) Откройте Панель управления → Устройства и принтеры.
2) ПКМ на принтер → Свойства принтера → Порты.
3) Нажмите Добавить порт → Стандартный TCP/IP-порт.
4) Укажите IP-адрес принтера
5) Выберите Тип устройства → Generic Network Card.
После создания порта — выберите его вместо WSD и примените. После этого WSD-порт можно удалить.
Если принтер использует универсальный драйвер Windows (WSD), попробуйте установить PCL или PS драйвер от производителя вручную, указав IP-адрес.

Отладчик встроенных скриптов

2026-02-27T09:43:38Z

Sammy: /* Пример 3: Отладка скрипта с работой с базой данных */

= Интерфейс =

[[Файл:ScriptDebugger.png]]

'''Отладчик скриптов''' — рабочий инструмент для разработки и диагностики [[Руководство_программиста|скриптов встроенного языка]].
Он позволяет запускать скрипты в режиме отладки, останавливать выполнение на нужных строках, анализировать переменные и подключаться к уже запущенным скриптам.
Вы можете запустить отладчик из:
* Через меню '''Отчеты > SQL > Выполнить > Запустить отладчик'''.
* Через меню '''Отчеты > Дополнительные возможности > Редактировать'''.
* Горячей клавишей '''Ctrl+Alt+D''' в главном окне приложения.

= Основные возможности =

* '''Запуск в режиме отладки''' — выполнение скрипта с остановкой на заданных строках
* '''Просмотр переменных''' — автоматическое отображение значений всех переменных при остановке
* '''Наблюдение за выражениями''' — вычисление произвольных выражений при каждой остановке
* '''Точки останова''' — остановка выполнения на выбранных строках кода
* '''Подключение к скриптам''' — подключение к скрипту запущенному без отладчика
* '''Работа с файлами''' — открытие, сохранение и отслеживание изменений файлов скриптов
* '''Расширенный редактор''' - подсветка парных скобок, отображение скрытых симолов, закладки.

= Интерфейс отладчика =

== Редактор кода ==

Основная область для написания и редактирования скрипта. Редактор поддерживает:
* Подсветку синтаксиса
* Нумерацию строк
* Визуальное отображение точек останова (красные кружки в левом поле)
* Подсветку текущей строки выполнения (желтый фон)
* Подсветку парных скобок
* Отображение скрытых символов
* Закладки для быстрой навигации
== Лог ==

Отображает:
* Вывод сообщений напрямую из скрипта командой '''print'''
* Сообщения отладчика (остановка на breakpoint, ошибки)

== Кнопки управления ==

* '''Запустить''' — Запуск скрипта в режиме отладки (F9). При необходимости установите точки останова, cкрипт выполнится до первой точки останова или до ошибки.
* '''Остановить''' — Прерывание дальнейшего исполнения скрипта. Во время выполнения скрипта можно нажать и удерживать клавишу '''ESC''' для аварийной остановки.
* '''Продолжить''' — Возобновление выполнения после остановки скрипта (F9)

= Работа с отладчиком =

== Установка точек останова ==
Точки останова можно настроить перед запуском скрипта или когда выполнение скрипта приостановлено. Добавление точки останова:

'''Способ 1.''' Щёлкните левой кнопкой мыши в левой части нужной строки (область номеров строк). На строке появится красный кружок — точка останова установлена. Повторный щелчок удалит её.

'''Способ 2.''' Установите курсор на строку и используйте пункт меню '''Скрипт''' > '''Добавить точку останова (F5)'''.

== Просмотр переменных ==

Список '''Переменные''' содержит все переменные и объекты доступные в текущем инстансе интерпретатора. Список автоматически отображаются в момент остановки выполнения скрипта.

== Наблюдение за выражениями ==
Список '''Наблюдения''' показывает все добавленные пользователям выражения и их рассчитанные значения. Значения обновляются автоматически в момент остановки выполнения скрипта или после редактирования выражения. Для добавления наблюдения:
# Выделите текст в редакторе (например, имя переменной или выражение)
# Выберите в контекстном меню редактора пункт '''Добавить в наблюдение'''
# Либо используйте меню '''Скрипт''' > '''Добавить наблюдение (Сtrl+F5)''' и введите выражение вручную.

'''Примеры выражений:'''
* $a + $b — сумма переменных
* db.RecordCount — количество записей в наборе данных
* $i > 0 — логическое условие

= Работа с файлами =

== Открытие файла с отслеживанием ==

Меню '''Файл''' > '''Открыть и отслеживать'''.

Открывает файл скрипта и включает автоматическое отслеживание изменений на диске.
При изменении файла во внешнем редакторе текст автоматически обновляется в отладчике.

== Сохранение в файл ==

Всегда есть возможность сохранить скрипт в файл.
* Меню '''Файл''' > '''Сохранить в файл''' — Сохраняет текущий текст скрипта в файл. Если файл был сохранен ранее, по умолчанию предлагается предыдуший путь.

* Меню '''Файл''' > '''Сохранить (Ctrl+S)''' — Когда отладчик открыт без привязки к конкретному скрипту, то сохраняет изменения в файл.
'''Важно!''' Если отладчик открыли например из '''Отчеты''' > '''Дополнительные возможности''' > '''Редактировать''' то сохранения через пункт '''Сохранить (Ctrl+S)''' сохранения '''всегда''' будет происходить в базу, в файл изменения сохранены не будут.

= Сохранение =

Если отладчик открыт как редактор скрипта, доступны функции по сохранению напрямую в базу данных:
* Меню '''Файл''' > '''Сохранить (Ctrl+S)''' — сохранить скрипт в базу данных
* Кнопка '''Сохранить и закрыть''' — сохранить скрипт и закрыть окно отладчика

= Подключение отладчика к работающим скриптам =
Данная возможность позволяет подключить отладчик к скриптам изначально запущеным без него. Для начала работ, отладчик нужно перевести в режим '''ожидания запросов отладки'''. Далее необходимо запустить скрипт стандартным способом. Если в скрипте будет команда AttachDebugger - отладчик это увидит и начнется процесс отладки этого скрипта. Это удобно для отладки скриптов, которые работают в своем контексте:
* [[Печатные формы|Скриптов из печатных форм]]
* [[Дополнительные_возможности|Скриптов из системных событий]]
* [[Пользовательские_отчеты|Скриптов дополнительных возможностей]]
* [[Дополнительные услуги|Скриптов из дополнительных услуг]]

'''Как использовать'''

#'''В отладчике:'''
## Откройте отладчик скриптов, главное меню '''Отчеты''' > '''SQL''' > '''Выполнить''' > '''Запустить отладчик (F9)'''.
## Включите режим отслеживания: меню '''Файл''' > '''Ожидать команды AttachDebugger'''.
## В строке состояния отладчика появится сообщение '''Ожидание команды AttachDebugger...'''.
## Свернуть отладчик, если его закрыть то наблюдение остановится.
#'''В скрипте:'''
## Скрипт нужно подготовить. В скрипте нужно прописать команду '''AttachDebugger''' она должна быть '''первой командой''' или идти следующей строкой после тега начала скрипта '''<?>'''
## Запустить скрипт стандартным образом: Сформировать печатную форму, рассчитать стоимость доставки, выполнить действие для вызова события.
#'''Что происходит:'''
## При выполнении команды AttachDebugger - скрипт останавливается.
## Отладчик автоматически подключается к перехваченному скрипту.
## Текст скрипта загружается в редактор отладчика.
## Можно ставить точки останова, просматривать переменные и продолжать отладку.

Пример скрипта с запросом подключения к отладчику:
<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Команда `AttachDebugger` должна быть первой командой в скрипте.
* Если режим отслеживания не включён, команда AttachDebugger в скрипте игнорируется и ничего не делает.
* В режиме отслеживания может работать только один отладчик.
* Если скрипт исполняется в шедулере или в другом вспомогательном потоке, то подключится к нему не получится. Отладка работает только в текущем потоке приложения.

= Горячие клавиши =

{| class="wikitable"
|-
! Клавиша !! Действие
|-
| '''F9''' || Запустить скрипт в режиме отладки или продолжить исполнение
|-
| '''ESC''' || Аварийная остановка скрипта (удерживать)
|-
| '''F5''' || Добавить или удалить точку останова
|-
| '''Ctrl+F5''' || Добавить наблюдение
|-
| '''Ctrl+S''' || Сохранение изменений в базу данных, если скрипт был открыт для редактирования в отладчике
|-
| '''Ctrl+1..9''' || Перейти в закладку 1 .. 9 в редакторе кода
|-
| '''Ctrl+Shift+1..9''' || Добавить закладку 1 .. 9 в редакторе кода
|-
| '''Ctrl+Shift+U''' || Двигать выбранный блок влево
|-
| '''Ctrl+Shift+I''' || Двигать выбранный блок вправо
|}

= Настройки редактора =

== Перенос строк ==

Контекстное меню редактора > '''Перенос строк'''.

Включает или выключает автоматический перенос длинных строк.
Настройка сохраняется и восстанавливается при следующем запуске отладчика.

== Отображение специальных символов ==

Контекстное меню редактора > '''Показать специальные символы'''.

Показывает пробелы и табуляции в виде специальных символов.
Удобно для поиска лишних пробелов и контроля форматирования кода.

= Примеры использования =

== Пример 1: Отладка скрипта с точками останова ==

'''Задача.''' Проверить корректность простого цикла суммирования. Пример скрипта:
<source lang="json">
<?>
set($i, 10);
set($sum, 0);
while($i > 0,
set($sum, $sum + $i);
set($i, $i - 1)
);
showmessage($sum);
</source>

План действий:
# Откройте отладчик, главное меню '''Отчеты''' > '''SQL''' > '''Выполнить''' > '''Запустить отладчик (F9)'''.
# Введите скрипт
# Установите точку останова на строке set($sum, $sum + $i);.
# '''Запустите скрипт (F9)'''.
# При остановке просмотрите значения $i и $sum в списке переменных.
# Добавьте выражение наблюдения $sum + $i.
# Нажимайте '''Продолжить''', наблюдая, как меняются значения до завершения цикла.

'''Что даёт отладчик:'''
* Видно, как накапливается сумма на каждом шаге.
* Можно быстро обнаружить ошибки в логике цикла.

== Пример 2: Отладка скрипта с условиями ==

'''Задача.''' Проверить, корректно ли выбирается максимум из двух значений. Пример скрипта:
<source lang="json">
<?>
set($a, 10);
set($b, 20);
if($a > $b,
set($result, $a),
set($result, $b)
);
showmessage($result);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке if($a > $b.
# Запустите скрипт (F9).
# При остановке просмотрите значения $a и $b.
# Добавьте выражение наблюдения $a > $b.
# Продолжите выполнение и посмотрите, какое значение попало в $result.

'''Что даёт отладчик:'''
* Понятно, при каких значениях срабатывает та или иная ветка условия.
* Удобно тестировать разные комбинации входных данных.

== Пример 3: Отладка работы с базой данных ==

'''Задача.''' Проверить правильность выборки и обработки данных из базы. Пример скрипта:
<source lang="json">
<?>
new('TSelfADO', 'db');
db.Open('SELECT code FROM city WHERE name Like "%Москва%"');
if(db.RecordCount > 0,
set($code, int(db.FieldByName('code'))),
0
);
showmessage($code);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке if(db.RecordCount > 0.
# Запустите скрипт (F9).
# При остановке просмотрите значение db.RecordCount.
# Добавьте выражение наблюдения db.FieldByName('code').
# Продолжите выполнение и убедитесь, что в $code попало ожидаемое значение.

'''Что даёт отладчик:'''
* Видно, сколько записей вернул запрос.
* Можно проверить конкретные значения полей перед дальнейшей обработкой.

== Пример 4: Отладка скрипта через AttachDebugger ==

'''Задача.''' Подключиться к скрипту запущенному без отладчика.
Пример скрипта:
<source lang="json">
<?>
AttachDebugger;
new('TSelfADO', 'db');
db.Open('SELECT COUNT(*) as cnt FROM address WHERE date_put IS NULL');
set($count, int(db.FieldByName('cnt')));
if($count > 100,
showmessage('Внимание! Много недоставленных адресов!'),
0
);
</source>

План действий:
# Откройте отладчик скриптов.
# Включите режим отслеживания меню '''Файл''' > '''Ожидать команды AttachDebugger'''.
# Откройте '''Отчеты''' > '''SQL''' введите скрипт из примера.
# Запустите скрипт через меню '''Выполнить''' > '''Выполнить как скрипт (F7)'''.
# Когда выполнение дойдёт до AttachDebugger, отладчик автоматически подключится.
# Установите точку останова на строке if($count > 100.
# Продолжите выполнение и проанализируйте значение $count.

'''Что даёт отладчик:'''
* Можно разбирать сценарии, которые запускаются не из отладчика, а из печтаных форм, дополнительных услуг и т.д.
* Скрипт становится доступен для анализа так же, как и обычный скрипт, запущенный из отладчика.

== Пример 5: Отладка скрипта с циклом FOR ==

'''Задача.''' Проверить корректность вычислений в цикле FOR. Пример скрипта:
<source lang="json">
<?>
set($sum, 0);
for($i, 1, 10,
set($sum, $sum + $i)
);
showmessage($sum);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке set($sum, $sum + $i);.
# Запустите скрипт (F9) и просматривайте значения $i и $sum при остановках.
# Добавьте выражение наблюдения $sum + $i для контроля вычислений.

'''Что даёт отладчик:'''
* Пошагово видно, как формируется итоговая сумма.
* Удобно находить ошибки в граничных условиях цикла.

== Пример 6: Использование выражений наблюдения ==

'''Задача.''' Одновременно контролировать несколько взаимосвязанных значений. Пример скрипта:
<source lang="json">
<?>
set($a, 10);
set($b, 20);
set($c, 30);
set($result, $a + $b + $c);
showmessage($result);
</source>

План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке set($result, $a + $b + $c);.
# Запустите скрипт (F9).
# Добавьте выражения наблюдения:
#* $a + $b
#* $b + $c
#* $a + $b + $c
# При остановке сравните значения выражений и итоговый результат.

'''Что даёт отладчик:'''
* Одновременно видно несколько ключевых показателей.
* Легче находить расхождения между промежуточными и итоговыми значениями.

Дополнительные возможности

2026-02-10T07:50:30Z

Sammy: /* Скрипты */

== Настройка для печатной документации ==

'''CustomGivnAct''' - Функция позволяет заменить печатную форму, акта передачи материальных ценностей (печать из выдачи) на пользовательскую. Включить использование этой возможности можно в переменных "Справочники" -> "Переменные" -> "Печать" -> "Акты передачи курьеру" -> "Печатная форма акта: Пользовательская".
Объявленные переменные
%code% - коды записей в выдаче которые необходимо распечатать
%docdate% - дата установленная в выдаче
%dockurier% - ФИО курьера показанного в выдаче
%dockurierfull% - Значение выбранного элемента в дереве (если есть выбранный узел дерева , иначе фио курьера)

Пользовательская форма акта, будет печататься только по заказам со статусом "На руках".

'''OnBeforePrintNakls''' - Вызывается перед печатью накладных, содержит %code% - коды всех адресов (через запятую).

'''OnAfterPrintNakls''' - Вызывается после печати накладных, содержит %code% - коды всех адресов (через запятую).

'''OnBeforePrintOneNakl''' - Вызывается перед печатью накладной, содержит %code% - код адреса.

'''OnAfterPrintOneNakl''' - Вызывается после печати накладной, содержит %code% - код адреса.

'''OnBeforePrintSticker''' - Вызывается перед печатью наклейки, содержит %code% - код адреса, %barcode% - ШК наклейки.

'''OnAfterItemPrint''' - Вызывается после печати наклейки из карточки номенклатуры. Поддерживает поля ввода - input. Содержит %code% - код номенклатуры item.code, %Naimen% - наименование, %country% - название страны, %Count% - указанное количество копий к печати.

'''PrintCustomSticker''' - Функция позволяет установить пользовательскую печатную форму для наклеек (из интерфейса "Печать ведомостей/наклеек"). Вызывается если выбран тип наклейки 15 (переменная StickerForm). Содержит %RectLeft%, %RectTop%, %RectRight%, %RectBottom% - границы прямоугольника на холсте принтера, в которые надо печатать (для поддержки табличной печати на A4), %RecNumber% - номер текущей записи датасета, %CurrentBarCode% - ШК, рассчитанный в зависимости от параметров в интерфейсе "Печать ведомостей/наклеек". %ACopyNo% - номер копии, нумерация с 1. %KolvoStr% - Стандартный текст "текущее место/всего мест", с учетом возможной печати этикетки на одно место из нескольких. Также содержит весь датасет, использующийся в других типах наклеек. В момент вызова функции, принтер уже запущен и начат документ, объект TPrinter в функции создавать не нужно, необходимо только создать объект TCanvas, он создастся как ссылка на текущий холст принтера.

'''PrintItemSticker''' - Вызывается перед печатью наклейки из карточки номенклатуры, для возможности распечатать уникальную наклейку для номенклатуры по заложенным в допвозможности условиям. Содержит %clientbar% - ШК наклейки. Если наклейка распечатана из допвозможности возвращает true, в противном случае false и будет распечатана стандартная наклейка, заложенная в системе

'''ChangeSchetDetailQuery''' - Вызывается формировании / пересчете счета. Возвращает строку разбитую через CRLF на две. Первая строка заменяет поля в запросе по детализации счета, вторая меняет строку группировки. Обязательные поля: zakazcnt - кол-во заказов, price - стоимость курьерских услуг, cnt - количество, pr - общая стоимость курьерских услуг.

'''OnAutoPrintManSticker''' - вызывается перед автопечатью сопроводительного документа к манифесту при заполнении номера пломбы (такая возможность включается уставкой печатаемой формы в переменной AutoPrintManSticker), содержит %code% - код манифеста, %mnf_date% - дату манифеста, %transporter% - код перевозчика, %store% - код филиала-получателя манифеста. Если доп.возможность возвращает true - автопечать происходит, false - нет.

'''OnBeforePrintAddresses''' - Вызывается из формы печати ведомостей/наклеек после нажатия на кнопку "ОК", содержит %code% - коды всех адресов (через запятую).

== Настройка всплывающих окон==

'''OnGivnStateChanged''' - Вызывается в транзакции при изменении статуса выдачи. В параметре %code% указан код выдачи. В %pickupDocId% указан код на таблицу docs, документ приема забранных корреспонденций у курьера (доска приема при закрытии забора). Переменная %RetNotScanned% принимает значение true, если при установленной переменной "Запрашивать возвратные документы при приеме" = "Требовать маркировки наклейкой" пользователь не стал сканировать наклейку.

'''OnAfterGivnStateChanged''' - Вызывается после транзакции, при изменении статуса выдачи. В параметре %code% указан код выдачи. В %pickupDocId% указан код на таблицу docs, документ приема забранных корреспонденций у курьера (доска приема при закрытии забора)

'''OnBeforeAddressSave''' - Вызывается перед сохранением изменений в карточке корреспонденции. Код выполняется не в транзакции и есть возможность показывать диалоговые окна. В качестве параметра передан объект fieldlist (объект полный аналог addressrecord в доп. услугах). . Если результат функции -1, то происходит отмена сохранения без ошибки (abort).

'''OnBeforeBaseSave''' - Вызывается перед сохранением изменений в карточке срочного заказа. Код выполняется не в транзакции и есть возможность показывать диалоговые окна. В качестве параметра передан объект fieldlist (объект полный аналог таблицы base). Теги %date_put%, %time_put%, %message% - содержат дату вручения, время вручения и инфо о доставке соответственно. Если результат функции -1, то происходит отмена сохранения без ошибки (abort).

'''OnAfterAddressSave''' - Вызывается после сохранения карточки корреспонденции в транзакции. Тег %code% - равен коду адреса; %Form3FrameMode% равен 1, если корреспонденция заполняется из интерфейса: "Функции - Ввод заявок по фото".

'''OnBarScan''' - Скриптовая обработка штрих-кода перед поиском

'''AfterAddressAcceptance''' - Событие после приема корреспонденции на склад (например,заказы - прием корреспонденции). Код выполняется не в транзакции и есть возможность показывать диалоговые окна. Содержит %Code% - код адреса, %StrBarCode% - отсканированный штрих-код. При вызове из интерфейса доски приема либо приема корреспонденции передается дополнительный тег %NewMass%, который содержит массу проставленную весами, содержит -1 если проставление массы отключено.

'''BeforeAddressAcceptance''' - Событие перед приемом корреспонденции на склад (например,заказы - прием корреспонденции). Код выполняется в транзакции. Содержит %Code% - код адреса; %StrBarCode% - отсканированный штрих-код; %mass% - массу, если значение меньше 0 значит весы выключены; %l%, %w%, %h% - габариты; %MultiBarCode% - истина если это наклейка на место; %SetKolvo% - проставлять принятые места, место может быть уже принято; %ClientCode% - код клиента (clients.code); %PackCode% - код места (packages.code) . Если функция возвращает значение больше 0, то это будет новой массой места или корреспонденции.

'''OnAddToShippingPlace''' - событие после добавления корреспонденции в мешок манифеста. Код выполняется в транзакции. Содержит %сode% - код адреса, %BarCode% - штрих код который отсканировали,%ShippingPlace% - код мешка

'''GetTypeShippingPlace''' - событие перед добавлением корреспонденции в мешок манифеста. Задача события распределить корреспонденцию между мешками. Результат функции код мешка, в который необходимо поместить корреспонденцию. Содержит %сode% - код адреса.

'''OnBeforePlanToManifest''' - событие перед планированием корреспонденции в манифест. Предназначено для дополнительных проверок. Выполняется до транзакции. Содержит %code% - код манифеста, %AddrList% - список кодов адресов через запятую. Объявление события отменяет системную проверку на возможность доставки адреса филиалом получателя, ее нужно реализовывать в этом событии.

'''OnBeforeScanToManifest''' - событие перед добавлением корреспонденции в мешок манифеста. Предназначено для дополнительных проверок. Выполняется до транзакции. Содержит %code% - код манифеста, %Address% - код помещаемого адреса

'''OnBeforePlanning''' - событие перед планированием одного или нескольких отправлений на курьера. Содержит %сode% - код курьера, %AddressCodes% - код(ы) планируемых корреспонденций.

'''OnAfterPlanning'''- событие после планирования планированием одного или нескольких отправлений на курьера. Содержит %сode% - код курьера, %AddressCodes% - код(ы) фактически запланированных корреспонденций.

'''DAILY''' - задание выполняемое один раз в день

'''OnGivnKurierStateChanged''' - событие вызывается после изменений данных со слов курьера (статуса, времени или причины недоставки). Вызывается даже при получении данных из мобильного приложения курьера. В событии запрещено показывать диалоги, т.к. это может остановить синхронизацию данных с ЛК. Содержит %сode% - код выдачи.

'''OnBeforeGivnStatus''' - событие срабатывает перед установкой статуса выдачи, не в транзакции. В параметре %code% указан код выдачи, %status% - устанавливаемый статус,%kurier% - код курьера, %date% - дата выдачи, %address% - код адреса

'''OnBeforeClientSave''' - событие срабатывает перед сохранением изменений в карточке клиента. Код выполняется не в транзакции и есть возможность показывать диалоговые окна. В качестве параметров переданы %code% (содержит код клиента) и объект fieldlist (полный аналог addressrecord в доп. услугах), который содержит ещё не сохранённую информацию о карточке клиента, а так же все её пользовательские поля. Если результат функции -1, то происходит отмена сохранения без ошибки (abort).

'''OnAfterClientSave''' - событие срабатывает после сохранения изменений в карточке клиента. Код выполняется в транзакции. В качестве параметров переданы %code% (содержит код клиента) и объект fieldlist (полный аналог addressrecord в доп. услугах), который содержит сохранённую информацию о карточке клиента, а так же все её пользовательские поля с предыдущими значениями, которые можно получить через функцию _Former('VarCode', значение, 'VarValue')

'''OnBeforeBasePutCheck''' - событие срабатывает при проставлении галки на вкладке срочных заказов. Код выполняется не в транзакции и есть возможность показывать диалоговые окна. В параметре <nowiki>%code%</nowiki> указан код срочного заказа, а в параметре <nowiki>%BasePutCheckType%</nowiki> указан тип проставления: 0 - если галка, 1 - если плюс. Если результат функции -1, то отмена выполняемой функции (abort).

'''OnAfterCreateSpecialSMA''' - событие срабатывает после создания нового АПД для клиента. Код выполняется вне транзакции, потому есть возможность показывать диалоговые окна. В качестве единственного параметра %code% передается код созданного АПД.

'''OnBeforeReturnIncome''' - Событие перед приемом возврата на вкладке выдача. Код выполняется вне транзакции. Содержит %Code% - код адреса. Функция заполняет две переменные: ''$mass'' - масса возврата корреспонденции (проставляется только если значение переменной больше нуля, а если это значение больше массы корреспонденции, то будет использовано в качестве массы места) и ''$kurier'' - код вернувшего курьера (если пустое или равно нулю, то проставляется стандартный код курьера ВОЗВРАТ НА СКЛАД [15]).

'''OnBeforeCreatePickup''' - Событие перед созданием забора правой кнопкой мыши в списке заказов. Код выполняется вне транзакции. Содержит %Code% - код заказа. %FromCompany% - компания, у которой осуществляется забор (поле target), %FromAddress% - адрес забора

'''AfterTicketAnswer''' - Событие происходит после ответа на тикет. %code% - код сообщения, %TimeSpent% - кол-во потраченных минут, %ticket% - номер тикета. Доп. возможность может отключить стандартный ввод затраченного времени, для этого нужно вернуть любое значение.

'''OnAfterTownSave''' - событие срабатывает после заведения нового населенного пункта через интерфейс справочника городов. Параметры: %code% - код населенного пункта, %name% - название населенного пункта, %city% - код региона (области).

'''OnSetAddressState''' - событие срабатывает при изменении пользовательского статуса в карточке корреспонденции. Параметры: %State1% - текущий выбранный статус, %OldState1% - предыдущий выбранный статус, так же в доп. возможности доступен объект FieldList на корреспонденцию.

'''OnBeforeManifestSave''' - событие, срабатывает перед сохранением в карточке манифеста, выполняется перед транзакцией потому можно показывать диалоговые окна. Параметры: %Code% - код манифеста, %StoreFromCode% - филиал-отправитель, %StoreCode% - филиал получатель, %SentDate% - дата отправки.

'''OnAfterManifestSave''' - событие, срабатывает после сохранения в карточке манифеста, выполняется в транзакции потому показывать диалоговые окна нельзя. Параметры: %Code% - код манифеста, %StoreFromCode% - филиал-отправитель, %StoreCode% - филиал получатель, %SentDate% - дата отправки.

== Настройка документов ==
'''CustomAddressPrnForm2''' - Кастомная реализация упрощенной печатной формы. В карточке заказа установлена галка Простые, и установлена переменная "Справочники" -> "Переменные" -> "Печать" -> "Упрощенные печатные формы" -> "Тип упрощенной печатной формы: 5"

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

'''OnShelvingBarScan''' - Обработка отсканированного штрих-кода при комплектации.

'''AdditionalStringForSMA''' - задает дополнительные условия для формирования АПД (наиболее часто: разделения актов на нал. и безнал, помимо этого практически неограниченные возможности по изменению условий для отбора корреспонденций в акт, учета их доставленности и т.п.) Содержит %code% - код клиента, переменную %ActPayType% со значениями типов оплаты входящих в акт отправлений: "nal" - наличный, "bnal"- безналичный,"all" - все, а ткаже %ActDateTo% - с датой, до которой создается акт. Может возвращать строку, разделенную символами переноса строки. (На 17.09.2021 в возвращаемой строке предусмотрен 1 символ переноса, т.е. строка состоит из двух частей.) В этом случае часть строки до первого переноса будет использоваться в запросе как доп. условие отбора, часть строки после первого символа пеерноса - в качестве дополнительного условия для определения "выполненности" доставки (поле specialsma.Made). С помощью второго модификатора можно сделать например так, чтобы корреспонденции с незаполненными датой/временем вручения считались доставленными.

'''CustomBillDetaling''' - Кастомная детализация счета. Установка переменной $CancelCustomDetail в true, включает вывод стандартной детализации. В переменной $schet - код счета по которому строится детализация.

'''OnSchetChanged''' - Выполняется при удалении счета и его изменении. Содержит %code% - код счета schet.code

'''QRCodePurpose''' - задает строку "Назначение платежа" (тэг "Purpose") в платежном QR-коде счета. По умолчанию "Курьерские услуги". Содержит %code% - код счета schet.code, %Source% - код клиента clients.code

'''ExceptionsForAPK''' - Задает дополнительные критерии поиска корреспонденции при формировании акта передачи корреспонденции(АПК). Содержит %Boxes% - псевдоним таблицы вложений используемый в запросе. Функция возвращает !ДВЕ! части sql запроса разделенных CRLF. При отборе в АПК используется два запроса. Первый - отбирает не доставленные заказы и возвраты документов, в него будет подставлено условие слева от разделителя CRLF. Второй запрос отбирает возращенные товары, в него будет подставлено условие справа от разделителя CRLF или вся строка условий если в строке нет разделителя CRLF (оставлено для обратной совместимости, в версии программы до 1115 фильтрация была только во втором запросе). %AdditionalParam% - дополнительный параметр, который можно установить в интерпретаторе при вызове функции CreateAddressTransferAct.
пример кода по умолчанию, фильтр только по второму запросу, вложение с названием "Доставка" - не попадает в АПК
<NOWIKI><?>
SET($ExcStr,' and %Boxes%.Name not like ''%Доставка%'' ');
$ExcStr</NOWIKI>

пример для изменения фильтрации сразу у двух запросов:
<NOWIKI><?>
SET($WHERE1,''); rem('условие отбора не доставленных и возврата документов');
SET($WHERE2, ''); rem('условие отбора возврата товаров');
$WHERE1 + CHAR(13) + CHAR(10) + $WHERE2</NOWIKI>

'''OnOrderCountCalc''' -Для расчета стоимости доставки необходимо учитывать кол-во отправлений. Доп. возможность возвращает часть SQL запроса, уточняющий условия поиска. Содержит %code% - равен значению переменной "Считать кол-во отправлений по текущему месяцу" (UseCurrentMonthCount, нет - 0, да - 1)

'''OnGetZakazCount''' - подменяет стандартный подсчет количества отправлений для расчета стоимости доставки (в том чисте отменяется вызов доп.возможности OnOrderCountCalc). Должна возвращать кол-во корреспонденций. В процедуру передаются следующие переменные: %CntAccType% - вид подсчета: 0-по заказу, 1-за месяц по клиенту; %code% - код клиента (обязателен для вида подсчета 1); %ZakazDate% - дата заказа; %CountByMonthType% - способ подсчета заказов за месяц (1-по текущему месяцу; 0 - по предыдущему); %UseCurrentUrgency% - 1:подсчитывать только корреспонденцию определенного режима срочности; %Mode% - этот режим срочности (при подсчете по заказу учитываются так же связанные режимы срочности, указанные в параметре 5 режима срочности в таблице статусов); %DatePut% - дата доставки (добавлено для альтернативных видов подсчета, может быть null); %SeparateIntercityDelivery% - 1:не учитывать междугородние доставки; В функцию так же передается объект fieldlist.

'''OnSMABarcodeScan''' - событие вызывается при сканировании штрихкода АПК в списке актов. %code% - код АПК (sendmoneyact.code)

'''OnPaintSMAColumns''' - вызывается при прорисовке таблицы в форме списка АПД/АПК. В функцию передается DataSet, содержащий поля таблиц SendMoneyAct и Clients, а так же пользовательские поля клиентов, называющиеся ufX, где X - номер поля (в статусах). Функция должна возвращать строку следующей структуры:
Поле1_таблицы, Цвет_фона, Поле2_таблицы, Цвет_фона и т.п. Возврат нечетного числа параметров эквивалентен возврату пустой строки (цвет не меняется)

'''CustomZPDetail''' - кастомное дополнение к детализации зарплаты (Специальная надбавка). Вызывается из скриптовой детализации зарплаты. Предназначено для расчета и вывода в детализацию значения какой-либо специальной надбавки, определенной пользователем. Входящие параметры: %code% - код платежа в таблице kurier_pays, %kurier% - код курьера. Возвращает строку, где через запятую указаны Название надбавки и ее значение. Если эта строка не содержит двух параметров - ничего не выводится.

'''ZPAdditionalSheets''' - кастомное дополнение к детализации зарплаты - дополнительный лист(листы) на форме детализации. В функцию передается DataSet из детализации зарплаты, ссылка на объект Excel (имя - xl). Внутри функции нельзя объявлять объект TSelfAdo с именем DB (он объявлен в детализации). Номер новой страницы Excel передается в переменной $page.

'''OnAddrInventoryAfterCreateDoc''' - вызывается в транзакции, в процедуре создания документа инветаризации корреспонденции. Входящие параметры: %code% - код созданного документа инвентаризации.

'''AddrInventoryAdditionalSQL''' - позволяет модифицировать запрос на создаваемый документ инвентаризации корреспонденции. Используется для наложения дополнительных фильтров. Входящие параметры: %code% - код созданного документа инвентаризации. %header% - часть SQL запроса в которую необходимо сделать вставки, возможные варианты join, where.
Пример использования '''AddrInventoryAdditionalSQL''', добавление фильтра по пользовательскому полю.
<source lang="SQL">
<?>
if('%header%'='join', 'left join userfields uf on uf.sourcecode=b.source and uf.sourcetable=2 and uf.varvalue=1',
if('%header%'='where', 'and ifnull(uf.varvalue, "F") = "T"'
,''))
</source>
.

== Настройка вида маркера ==
Настройки находятся в "Отчеты" -> "Дополнительные возможности" - "Системные". 

В функции передается объект Table2Map типа [[Руководство программиста#Объект TFieldObject|TFieldObject]]. Получить поля с примерами значений из него можно например так:
showmessage(table2map._GETTABLEINFO)
(текст большое сообщения можно скопировать в буфер комбинацией Ctrl-C).

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

Так же текущее состояние окна карты доступно через переменные:

$PlanDate - Выбранная дата, на которую планируется.

$KurierCode - Код выделенного курьера.

$MetroCode - Код выделенной станции метро (маршрута).

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

set($s, try(
error('вот тут ошибка, которую вы увидите в виде сообщения');
));
if($s, showmessage($s), '');

'''MapObjectFigure''' - Доп. возможность позволяет установить вид маркера на карте. Результат определяет фигуру: 1 - перевернутый треугольник (острым концом вниз), 2 - треугольник, 3 - увеличенный перевернутый треугольник (острым концом вниз), чтобы квадрат не мог его перекрыть, 4 - квадрат, 5 - ромб, все остальное круг. Ромб поддерживается с версии 960. 
Например:
if(table2map.zabor, 2, if(StrDateToFloat(table2map.DatePeriod) = $PlanDate, 3, 4))
Выводит треугольник, если отправление - забор. Иначе - если дата план отправления равна дате, на которую планируется - увеличенный перевернутый треугольник, иначе - квадрат.

'''MapObjectColor''' - Доп. возможность позволяет установить цвет маркера на карте.
При помощи данных параметров можно создать условия отображения маркеров. 

Для доступа к настройкам доступны переменные:

$Color

$DefaultColor

$PlanedColor

$SelectedPlanedColor

$GetKurierColor

Например:
if((table2map.kurier<20)*(StrDateToFloat(table2map.DatePeriod) = $PlanDate), 16753920, $color)
Не запланированные отправления на текущий день будут отображаться выбранным цветом, иначе - цветом по-умолчанию.

== Речь диктора ==

'''OnGivnVoice''' - выполняется после изменения статуса выдачи. Параметр <nowiki>%code%</nowiki> содержит код выдачи, <nowiki>%State%</nowiki> содержит код устанавливаемого статуса, <nowiki>%OldState%</nowiki> - код старого статуса (0 если не было). Позволяет отключать стандартный звук ОК, если возвращает не 0.

'''OnDashboardManifestVoice''' - выполняется после сканирования адреса в интерфейсе приёма манифестов. Параметр <nowiki>%code%</nowiki> содержит код корреспонденции. Позволяет отключать стандартную диктовку программой (код курьера, вес и т.д.), если возвращает не 0.

== Настройка мобильного приложения ==

== Скрипты ==
'''OnEveryStartApp''' - выполняется при запуске программы.

'''OnEveryCloseApp''' - выполняет при закрытии программы.

'''OnBarScan''' - выполняется при получении ШК со сканера, в параметре %code% - получаем ШК. Если функция, что-то возвращает, то система будет использовать возвращенный ШК.

'''OnMapBeforeGeolocation''' - Вызывается перед отображаем адреса на карте. В функцию передается объект fieldlist.
Пример скрипта, переводящий адреса в НЕ найденные на карте, если станция метро НЕОПЕРЕДЕЛЕННАЯ.
<NOWIKI><?>
if(station=0,
_set('lon', null);
_set('lat', null);
_set('searchCoordinate', 'F');
,0)</NOWIKI>

'''OnSyncInsert''' - Выполняется для каждой добавленной записи при синхронизации с ЛК. Содержит %tablename% - название синхронизируемой таблицы.

'''OnSyncUpdate''' - Выполняется для каждой обновленной записи при синхронизации с ЛК. Содержит %tablename% - название синхронизируемой таблицы.

Если при получении новых адресов с ЛК, нужно поменять любое поле в таблице address, то необходимо использовать сразу два события OnSyncInsert и OnSyncUpdate. Адреса без вложений обрабатываются событием OnSyncInsert, адреса с вложениями будут обрабатываться событием OnSyncUpdate. Это связано с механизмом синхронизации, если в событии OnSyncInsert, проапдейтить поле в адресе с вложениями, то данные могут потеряться.
Когда адрес без вложений, то у него сразу station = 65535 и можно апдейтить. Если с вложениями, то у него сначала station = 65534, а после синхронизации вложений есть отдельный апдейт на 65535. Пример кода, для апдейта поля в адресах, события OnSyncInsert и OnSyncUpdate:
<NOWIKI>

<?>
rem(ticket 23584, 23583);
if( ('%tablename%'='address'),
query('UPDATE address a
JOIN trace t ON t.address=a.code AND t.state=1
JOIN zakaz z ON z.code=a.zakaz
SET
a.mode = IF(z.source=646, 3, 2)
WHERE
a.code = %code%
AND a.station=65535
AND (
(z.source=646 AND a.mode<>3) OR
(A.DATE_PUTN=DATE(t.Statetime) AND a.mode=1) OR
(A.DATE_PUTN=DATE_ADD(DATE(t.Statetime), INTERVAL 1 DAY) AND TIME(t.Statetime) > "21:59:59" AND a.mode=1)
)')
, '');</NOWIKI>
;

'''OnCalcSalary''' - Событие происходит после начисления зарплаты курьеру. %code% - код созданного начисления kurier_pays.code ; %dateto% - дата до которой рассчитали зарплату; И отдельно части зарплаты: %profit% -итоговая сумма; %Zarab% - сдельная часть; %Oklad% - оклад; %Friends% - выплаты за приведенных; %Other% - разное; %AgentMoney% - агентское вознаграждение; %StandingMoney% - Доплата за стаж; %Bonus%, %Shtraf% - бонусы и штрафы.

'''OnCalcAvans''' - Событие происходит после начисления аванса курьеру. %code% - код созданного начисления kurier_pays.code. Можно произвести дополнительные начисления и удержания из kurier_pays.profit.

'''OnTicketSetCusr''' - Пользовательский скрипт перед назначением ответственного в тикетах. %code% - код тикета; %Cusr% - код назначаемого пользователя (может быть равно NULL)

'''OnCreateAddressForActDelivery''' - Пользовательский скрипт вызывающийся в момент формирования корреспонденции на доставку АПД/АПК. Позволяет существенно доработать формируемую корреспонденцию. %code% - код акта sendmoneyact.code, %Client% - код клиента; %delivery% - флаг определяющий корр. на доставку акта (1, значение по умолчанию) или забор акта. fieldlist - объект с полями адреса (повторяет структуру таблицы address), dataset - объект дополнительными полями функции. Объект fieldlist является классом TMyFieldList и позволяет менять значения полей. Также измененный адрес можно сохранить прямо в событии, или он будет сохранен автоматически после выполнения скрипта. Для сохранения адреса используйте метод _save.

Пример, для клиента с кодом 3360, в корреспонденцию на доставку АПК, добавляем список корреспонденций попавших в него во вложения.
<source lang="sql">
<?>
if((client=3360)*(ActType=2),
rem('Ticket 70827, 2022-09-07 Anatoly and Sergey');
set($addresscode, fieldlist._save);
query('insert boxes (address, pos, name)
select '+$addresscode+' AS address, @q := @q + 1 AS pos,
CASE WHEN a.client_id <> '' THEN a.client_id WHEN a.strbarcode<>'' THEN a.strbarcode ELSE CONCAT(a.zakaz,"-", a.number) END AS `name`
FROM addressfld af
JOIN address a ON a.code=af.`address` ,(SELECT @q := 0 ) p
WHERE
af.`AddrTransferCode` = %code% AND af.`ReceivedInTransfer` > 0');
,0);
</source>

'''OnAfterPreassemblyScan''' - событие происходит после сканирования складского товара в корреспонденцию на вкладке «Склад». %code% - код корреспонденции, %ItemCode% - код товара, %ItemCnt% - количество отсканированного товара.

'''OnGeocodeScript''' - скрипт подключения к геокодеру клиента. Используется при включенной переменной "Справочники" -> "Переменные" -> "Подключения" -> "Карты" -> "Геокодирование" -> "Протокол геокодирования: Клиентский (скрипт OnGeocodeScript)". Имеет встроенные переменные:
*$address - адрес для геокодирования;
*$town - код города;
*$street и $home - упрощенный адрес;

Скрипт должен вернуть следующие переменные :
*$lon и $lat - координаты ;
*$goodaddress - нормализованный адрес (не обязательно);

<source lang="sql">
<?>
set($response, HTTPPOST('http://XXXXXXXX',
'{"query":'+ FormatTextJSON($address)+ '}',
'','','','',
'post', 'application/json', 10000));

if($response!'',
new('TJSON', 'json');
set($e, try(
json.SetText($response);
json.OpenChild('geo_data');
json.OpenChild('mid');
set($lat, sqlfloat(json.ChildNodeValue('lat')));
set($lon, sqlfloat(json.ChildNodeValue('lon')));
));
if($e, error('Ошибка в разборе ответа: '+$e), '');
, error('Пришел пустой ответ от геокодера')
);
</source>

'''OnFilterAddressRecalc''' - Позволяет отфильтровать коды адресов, для которых можно пересчитать стоимость. Событие происходит перед расчетом стоимости доставки из интерфейса программы для: актов, счетов, заказов, и т.д. Не работает для пересчета запускаемого из самой карточки корреспонденции.
%codes% - коды адресов для пересчета стоимости доставки. Формат: (1,2,3,...). %RecalcUserCode% - код пользователя запустившего пересчет (актуально для отложенных пересчетов).
Функция должна вернуть коды адресов, допущенных к пересчету в формате: (1,2,3,...)

<source lang="sql">
<?>
rem('2023-12-04 Sergey. Отключаем перерасчет стоимости доставки у корреспонденций в статусе - проверено,
если у пользователя нет права Счета-изменять. Тикет 79954.
Блокировка работает в связке с тикетом 77995.');
new('TSelfADO', 'DB');
DB.OPEN('SELECT a.code FROM courier.address a
LEFT JOIN courier.users u ON u.code=%RecalcUserCode%
LEFT JOIN courier.`userrules` ur ON ur.`GroupId`=u.grup AND ur.`RuleType`=1 AND ur.newruleid =78 -- RSA
WHERE ((a.state1<>8) OR (a.state1=8 AND ur.state="T")) AND a.code in %code%');
DB.ParseForIn('CODE')
</source>

'''OnRecalcBoldCntInFrame''' - срабатывает в карточке тарифа при перемещении курсора зоны. Возвращает целочисленное значение, равное количеству доставленных корреспонденций у клиента за предыдущий месяц. Срабатывает только при открытии карточки тарифа из карточки клиента. %ClientCode% - код клиента. %ZoneCode% - код зоны.

'''ChangeStatusColor''' - подменяет цвет фона сообщения в строке статуса в форме приема корреспонденции. Возвращает целочисленное значение - новый цвет фона, 0 - если цвет менять не нужно. Входящие значения: %code% - входящее значение цвета. Остальные переменные - булевского типа - отражают состояние Настроек: %Renum% - Перенумеровывать, %IgnoreDblScan% - Игнорировать ошибки повторного сканирования, %PrintNakl% - Печатать накладные, %Given% - Выдавать отправления, %PrintFiles% - Печатать файлы, %BarLine% - Включить поддержку штрих-кодовой линейки, '%CreateTrans% - формировать кассовые чеки.

'''GetLusrSQL''' - переопределяет столбец "Изменивший пользователь" в истории изменений. Должен возвращать часть SQL запроса для столбца lusr. Входящее значение %code% содержит код таблицы, для которой строится SQL-запрос истории.

'''OnBeforeSendSMS''' - выполняется перед рассылкой шаблона СМС. Содержит в себе %MessageText% - текст сообщения отправляемого по шаблону, %Phone% - номер телефона. Если возвращает значение -1, отправка стандартными средствами не происходит.

'''TariffCalculatorTotal''' - функция для настройки простой формы тарификатора. Работает в двух режимах: sql - запрос для построения грида. В режиме доступны теги: %ClientCode%' - код клиента, '%PriceCode%' - код прайса клиента. Столбцы SQL запроса строго фиксированы: code - код поля, fieldname - название поля, costparams - варианты цен через запятую (для отображения комбобокса), modlist - список названий для разных цен через запятую, modvalue - выбраный элемент. Второй режим это формула расчета строки, в этом режиме доступен dataset со всеми ранее рассчитанными строками и теги '%FieldCode%', '%Cost%', '%Quantity%', '%ClientCode%', '%PriceCode%', '%DefaultTotal%'.

<source lang="sql">
<?>
<?>
if('%code%'='sql',
'(SELECT s.statecode AS code, -- код поля
s.name AS fieldname, -- название поля
IFNULL(uf.varvalue, "") AS costparams, -- варианты цен через запятую (для отображения комбобокса)
IFNULL(unquotedstr(getparam(s2.advansed, 3)), "") AS modlist, -- список названий для разных цен через запятую
IFNULL(mods.`varValue`, '''') AS modvalue -- выбраный элемент
FROM states s
LEFT JOIN userfields uf ON uf.sourcetable=11 AND uf.sourcecode=%PriceCode% AND uf.varcode=s.statecode
LEFT JOIN userfields AS mods ON mods.`sourceCode`=%ClientCode%
AND mods.sourcetable=2 AND mods.varcode = CAST(uf.varcode AS SIGNED) - 20 AND mods.`varCode` IN (10,11)
LEFT JOIN states s2 ON s2.statetype=35 AND s2.`StateCode`=mods.`varCode`
WHERE s.statetype=45
AND IFNULL(s.hidden,"F")="F"
AND getparam(s.advansed, 1) <> "0"
ORDER BY s.statecode)
union (SELECT 1000,"ПОДДЕРЖКА", "1,2,3", "Поддержка 1, Поддержка 2, Поддержка 3","" )
'
,
if(%FieldCode%=1000,

case(
when(%Cost%=1,
100
);
when(%Cost%=2,
200
);
when(%Cost%=3,
300
);
)
,
%cost%*%Quantity%
)
)
</source>

Руководство программиста

2026-01-16T13:26:11Z

Sammy: /* Объект TBase */

== Основные положения ==

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

Как интерпретатор приводит типы:

1. При использовании значения как параметр функции интерпретатор автоматически приводит значение к типу, необходимому функции.

2. При операциях сложения, а также логических операциях, операнды приводятся к строке если хотя бы один из них имеет тип «строка». Например:
3.3+5 -> 8.3
‘3.3’+5 -> ‘3.35’
подобную проблему можно решить принудительно преобразовав тип:
float(‘3.3’)+5 -> 8.3

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

Как работают функции приведения типов:

1. При преобразовании строки к числу: функция «читает» строку до первого символа, не позволяющего создать число с плавающей точкой, при этом разделителем целой и дробной частей может быть как точка так и запятая. Если приведение производится к целочисленному типу, то после этого происходит округление. Например:
float('3.6qwerty735') -> 3.6
int('3.6qwerty735') -> 4

2. При преобразовании к булевому типу ложью считается пустая строка либо число 0, все остальное - истина

3. При преобразовании булевого типа к числу истина преобразуется в 1, ложь – в 0. Такое преобразование позволяет использовать сложение и умножение в качестве логических «ИЛИ» и «И» соответственно:
if((5=5)+(6=7), <a>, [b]) – условие истинно, выполнится код «a».

4. При преобразовании булевого типа к строке сначала происходит преобразование к числу:
(5=5)+'qwerty' -> ‘1qwerty’

== Описание синтаксиса ==

Команды разделяются точкой с запятой. Параметры функций разделяются запятыми. Каждая команда (даже цикл while) является функцией, возвращающей некоторое значение. Результатом выполнения составной команды (последовательности функций, разделенных точкой с запятой), является результат выполнения последней функции. Имена переменных, функций, объектов, а также их свойств и методов не чувствительны к регистру.
Константы: константы бывают целочисленными, дробными и строковыми. Значения целочисленных и дробных констант указываются «как есть» (в этом случае разделитель целой и дробной частей – точка), шестнадцатеричные значения начинаются с символа «$» и, если первая цифра – буква, она упреждается цифрой 0, а строковые – в одинарных кавычках. При этом, если внутри строковой константы встречается символ одинарной кавычки он должен быть задвоен, для указания интерпретатору того, что он не является признаком конца константы.
Операции сравнения: >, <, =, ! - Больше, меньше, равно, не равно соответственно.
Логические операции: + (ИЛИ), * (И).
Арифметические операции: +, -, *, /
Операция конкатенации строк: +

=== Функциональность базового объекта ===

'''SET($a, a)''' – присваивает переменной (1-й параметр) значение второго параметра. При отсутствии переменной – создает ее. Имена переменных должны начинаться с символа «$», а следующий символ не должен быть цифрой. Возвращает новое значение переменной. Функция используется только для задания значений переменных. Не допускается использования для задания значений свойств объектов. Для этого используются соответствующие методы этих объектов.

'''IF(a,b,c)''' или '''IF(a,b)''' – Условный оператор. В первом случае возвращает b, если a истинно (не равно нулю или пустой строке), иначе – c. Во втором случае – возвращает a, если оно истинно, иначе – b.

'''WHILE(a, b)''' – Оператор цикла. Выполняет b пока a истинно:
set($i, 10);
set($sum, 0);
while($i>0, set($sum, $sum+$i); set($i, $i-1));
$sum
Результат – 55

'''FOR($a, b, c, d)''' – Оператор цикла. Выполняет d пока $a последовательно присваиваются значения от b до с включительно:
set($sum, 0);
for($i, 1, 10, set($sum, $sum+$i));
$sum
Результат – 55

'''NEW(ClassName, InstanceName)''' – Создает экземпляр класса ClassName, назначает ему имя InstanceName. Возвращает порядковый номер созданного объекта. Доступ к свойствам и методам объектов осуществляется по имени объекта и имени свойства/метода, разделенным точкой. Именем объекта может быть и пустая строка, тогда доступ к его свойствам и методам будет осуществляться без указания имени, и, в случае совпадения имен свойств и/или методов со стандартными или свойствами/методами других объектов, использоваться будут соответствующие свойства/методы объекта, созданного ранее, а также такой объект невозможно уничтожить до окончания выполнения скрипта. Все объекты созданные во время выполнения скрипта уничтожаются автоматически после окончания его выполнения.

'''FREE(InstanceName)''' – Уничтожает объект с именем InstanceName. Возвращает 0. В случае отсутствия объекта с заданным именем вызывает ошибку.

'''ShowObjects''' – Возвращает список созданных объектов – названия классов и имена.

'''ERROR(message)''' – Вызывает ошибку с текстом message.

'''SHOWMESSAGE(message)''' – Отображает диалоговое окно с текстом message, останавливает выполнение скрипта до закрытия окна пользователем.

'''SimpleAskUser(Message)''' – Выводит диалоговое окно с текстом Message и кнопками «Да» и «Нет». Возвращает 1, если пользователь нажал кнопку «Да», иначе – 0.

'''TRY(a)''' – Выполняет a в «защищенном от ошибки» режиме. Если в процессе выполнения a возникает ошибка, возвращает текст ошибки, иначе – 0 (ложь).

'''REM(….)''' – Код в скобках игнорируется (комментарий).

'''EXEC(FileName, Params, Wait, WindowState)''' – Запускает внешнее приложение FileName с параметрами Params. Если Wait истинно – ожидает завершение процесса. Для WindowState доступны следующие числовые значения:
0 - SW_HIDE
1 - SW_SHOWNORMAL (по-умолчанию)
3 - SW_MAXIMIZE
6 - SW_MINIMIZE
Функция возвращает истину если приложение запущено успешно. Иначе – Ложь.
В случае успеха, при параметре Wait – истина кладет в переменную $LastResult код завершения приложения.

'''CASE''' - Оператор множественного выбора. Позволяет выполнить одно из нескольких действий в зависимости от условий. Синтаксис:
<source>
case(
when(условие1, действие1);
when(условие2, действие2);
...
else(действие_по_умолчанию);
);
</source>

Пример использования:
<source>

set($a, 10);
set($b, 50);

showmessage(
case(
when($a < 5, 50);
when($a < 10, 100);
when($a < 250, 200);
else($a*$b);
)
);
</source>

'''AttachDebugger''' - Команда позволяет подключить открытый [[Отладчик_встроенных_скриптов]] к текущему скрипту. Команда AttachDebugger должна быть '''первой командой''' в скрипте. Добавьте её в самое начало скрипта:

<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Как работает:'''
# При выполнении команды AttachDebugger скрипт останавливается.
# Отладчик автоматически подключается к выполняющемуся скрипту.
# Текст скрипта загружается в редактор отладчика.
# Можно ставить точки останова, просматривать переменные и продолжать отладку.

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Если режим отслеживания не включён, команда `AttachDebugger` игнорируется.
* В режиме отслеживания может работать только один отладчик.
* Команда AttachDebugger должна быть первой командой в скрипте.

=== Строковые функции ===

'''UpCase(s)''' – возвращает строку s в верхнем регистре.

'''LCase(s)''' – возвращает строку s в нижнем регистре.

'''Len(s)''' – возвращает количество символов в строке s.

'''Pos(s, substr [,start])''' – возвращает номер первого символа первого включения подстроки substr в строку s, возвращает 0, если включения подстроки отсутствуют. Параметр start - это позиция старта поиска, не обязательный параметр, по умолчанию равен 1. Поиск не чувствителен к регистру.

'''Param(s, i)''' – возвращает i-й элемент строки s, разделенной запятыми на элементы.

'''ParamsCount(s)''' - возвращает количество элементов строки s, разделенной запятыми на элементы.

'''SetParam(s, p, i)''' – заменяет на значение p i-й элемент строки s, разделенной запятыми на элементы.

'''Left(s, i [,full] )''' – возвращает i первых символов строки s. Параметр i, может быть строкой, тогда он считается разделителем и функция, возвращает строку слева от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Mid(s, i, j)''' - возвращает подстроку из s начиная с i символа и длиной j символов

'''Right(s, i [,full])''' – возвращает i последних символов строки s. Параметр i, может быть строкой, тогда он считается разделителем, функция ищет разделитель с конца строки, и возвращает строку справа от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Reverse(s)''' - возвращает строку s задом-наперед. Полезно например для поиска с конца функций Pos().

'''Char(i)''' – возвращает символ с кодом i.

'''Ord(s)''' – возвращает код первого символа строки s.

'''Replace(s, strFind1, strReplace1, [ strFind2, strReplace2, ... ], [caseInsensetive])''' - возвращает строку s, в которой все включения строк strFind заменены строкой strReplace. Параметры поиска и замены всегда должны быть в паре и их может быть несколько. caseInsensetive - неучитывать регистр, не обязательный параметр, по умолчанию включен.

'''RemSpace(s)''' – возвращает сроку s без начальных и конечных запятых и пробелов, а также начальных точек.

'''SumStr(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''с добавлением валюты'''. Необязательные параметры captions - позволяет изменить название валюты, формат строки может зависеть от текущего языка(посмотреть формат можно в "Справочники"-"Статусы"-"32 Валюты", в разделе "Дополнительная информация"). Language - код языка на котором необходимо вывести сумму прописью. По умолчанию если не обязательные параметры опущены, используются региональные настройки в переменных.

'''NumToStrSimple(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''без валюты'''. Параметры идентичны функции SUMSTR.

'''FullNameToShort(Name)''' – Возвращает фамилию и инициалы по полному ФИО Name.

'''MonthName1(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в именительном падеже.

'''MonthName2(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в родительном падеже.

'''StrForXML(s)''' - Подготавливает строку к парсингу как xml: Если находит в строке подстроку "UTF-8" - перекодирует ее из utf-8 в win-1251, убирает начальный знак вопроса, если такой встречается.

'''FixedIntToStr(i, len[, char])''' - Возвращает целое число i дополненное слева символами char (по-умолчанию - "0") до длины len.

'''Translate(format, [param1, param2, ...])''' - Функция перевода строки format в язык пользователя. Строка format может содержать параметры %s, %d - строка и число соответственно.

'''ExtractFileName(FilePath)''' - возвращает имя файла с расширением из полного пути к файлу FilePath.

====Функции перекодировки====
'''DecodeStr(s, charset)''' - Производит перекодировку строки s в кодировку CP1251. Кодировка строки s должна быть заранее известна и может быть :
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866, UNICODE. Имя кодировки следует передавать в точности без лишних символов.

'''EncodeStr(s, charset)''' - Производит перекодировку строки s в кодировку charset. Кодировка строки s должна быть CP1251, возможны следующие варианты перекодировки:
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Имя кодировки следует передавать в точности без лишних символов. UNICODE не работает с версии 2021, в ней строки по умолчанию в кодировке unicode.

Функции EncodeBase64(s), DecodeBase64(s), UrlEncode(s), UTF8Encode(s), UTF8Decode(s), Str2UTF(s) - устарели, используйте EncodeStr, DecodeStr.

====Транслитерация====

'''Translit(s)''' - транслитерация строки русского текста s латиницей

'''UnTranslit(s)''' - транслитерация строки s с латиницы на русский.

==== Экранирование ====

'''QUOTEDSTR(s)''' – квотирует строку s символом «\» (обратный слеш). Возвращает строку s, помещенную между символами одинарной кавычки, при этом все вхождения в строку s символов: «\», «"» и «'» экранируются квотирующим символом, а символы #0, #10 и #13 заменяются на \0, \n и \r соответственно.

'''SQLFloat(f)''' – Приводит число с плавающей точкой к виду, пригодному для SQL-запроса, т.е. к тексту с разделителем дробной части – точка.

'''FormatTextXML(s)''' - квотирует строку s для использования в XML. Производит замены спец. символов для корректности XML-синтаксиса.

'''FormatTextJSON(s)''' - переводит строку в формат JSON, экранирует служебные символы.

'''FormatTextBlob(s)''' - строка s содержит файл, функция перекодирует переданную строку в байты, используется для заполнения полей формата blob.

====Хеширование ====

'''HMACHash256(key, text)''' - создаёт хэш по алгоритму SHA256 для проверки целостности сообщения, key - секретный ключ, text - хэшируемое сообщение

'''MD5Hash(text)''' - создаёт хеш по алгоритму MD5

'''SignatureUrl(url)''' - Подписывает переданный URL. Функция возвратит переданный URL с добавленным в конце параметром, в котором будет записана подпись.

=== Функции работы с датой и временем ===

'''CurrTime''' – возвращает текущее время

'''CurrDate''' – возвращает текущую дату

'''CurrMillisecond''' - Возвращает количество миллисекунд прошедших с начала текущего года. Используется для точного расчета временных интервалов.

'''Today''' - возвращает текущую дату в числовом формате.

'''Day(dt)''' – возвращает день месяца даты dt.

'''Month(dt)''' – возвращает месяц года даты dt.

'''Year(dt)''' – возвращает год даты dt.

'''FirstDayOfMonth(dt)''' – Возвращает первый день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( FirstDayOfMonth( CurrDate() ) );
'''Полужирное начертание'''
'''LastDayOfMonth(dt)''' – Возвращает последний день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( LastDayOfMonth( CurrDate() ) );

'''DaysInMonth(month, year)''' – Возвращает количество дней в указанном месяце.

'''IncDay(dt, [count=1])''' – Возвращает дату, увеличенную на count дней.

'''SQLDate(dt)''' – Пытается конвертировать dt в дату, вернуть в формате «'YYYY-MM-DD'» (с апострофами), если не удается – возвращает «NULL».

'''SQLDateToDate(dt)''' – Переводит дату из SQL-формата в обычный.

'''DAYSBETWEEN(dt1, dt2)''' – Возвращает количество дней между датами dt1 и dt2. В случае ошибки приведения dt1 или dt2 к дате возвращает -1000.

'''TimeBetween(t1, t2)''' - Возвращает количество минут между временем t1 и t2. Если t1 > t2 то будет показано количество минут между t2 и t1. Параметр t может быть как в формате "HH:MM", так и в числовом. Если один из параметров не удалось привести к числовому типу возвращает -1000.

'''WorkDaysBetween(dt1, dt2, [DecreaseFirstDay=0], [DefaultHolidayVarNum=1])''' - Возвращает количество рабочих дней между датами dt1 и dt2. Параметр DecreaseFirstDay уменьшает dt1 на указанное количество дней (по умолчанию 0). В случае ошибки приведения dt1 или dt2 к дате возвращает -1000. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней(по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''TimePeriod(time1, time2)''' - Оформляет временной период. Возвращаемое значение зависит от наличия значения в параметрах. Возможные варианты: "time1 - time2" , "С time1" , "ДО time2".

'''StrDateToFloat(s, [time=false])''' - Переводит строку с датой s в числовой тип. Если параметр time включен, то в строке s должно быть указано время. Дата должна быть в формате "DD.MM.YYYY", а время "HH:NN". Если строку перевести не удалось возвращает 0

'''IsAWorkDay(dt)''' - Когда день dt является рабочим, возвращает true. Если произошла ошибка приведения даты возвращает -1000.

'''IncWorkDay(dt, [count=1],[DefaultHolidayVarNum=1])''' - Прибавляет count рабочих дней к дате dt. Возвращает дату в числовом формате, если произошла ошибка приведения даты возвращает -1000. По умолчанию параметр count равен 1 и не является обязательным. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней (по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''Sleep'''(n) - Задержка выполнения на n миллисекунд.

=== Функции приведения типов ===

'''INT(v)''' – возвращает значение типа “целое”, приводя вариантное значение v к числовому типу, а затем округляя его. В том числе используется как функция округления.

'''FLOAT(v)''' – возвращает значение типа “число”, приводя вариантное значение v к числовому типу, переводя в число цепочку символов до первого нецифрового символа (либо точки или запятой).

'''STR(v)''' – возвращает значение типа “строка”, приводя вариантное значение v к строковому типу.

'''Date(v)''' – возвращает дату, либо пустую строку, если не удается конвертировать v в дату

'''Time(v)''' – возвращает время, либо пустую строку, если не удается конвертировать v во время. Понимает числовое представление времени.

=== Математические функции ===

'''ROUNDUP(f)''' – округляет число f до ближайшего большего по модулю целого числа.

'''ROUNDDN(f)''' – округляет число f до ближайшего меньшего по модулю целого числа.

'''Money(f, CouldBeEmpty, ZeroFill, MakeSpace)''' - Округляет число f, до двух знаков после запятой. CouldBeEmpty - заменить число меньше 0,0001 на пустую строку. ZeroFill - Следить чтобы после запятой было два знака, если будет один, то добавить ноль. MakeSpace - Разделить разряды пробелом.
''Подсказка: для простого округления используется функция int()''

'''Abs(f)''' - возвращает модуль числа f.

'''Mod(x, y)''' - возвращает остаток от деления целочисленного числа x на целочисленное число y.

=== Константы ===

'''Null''' – Возвращает пустое значение.

'''Да''', '''True''', '''Нет''', '''False''' – константы, соответствующие булевым значениям.

=== Прочие функции ===

SetPhoneParams(CountryCode, TownCode) – Устанавливает глобальные настройки кода телефонных кодов страны и города соответственно. По-умолчанию код страны – 7, код города – 495.

PhonesCount(s) – Возвращает количество корректных телефонных номеров, найденных в строке s.

GetPhone(s[, n]) – Возвращает n-й корректный телефонный номер, найденный в строке s. Нумерация начинается с 1.

GetEmail(s) – Возвращает все корректные адреса email, найденный в строке s, разделенные запятыми (т.е. готовыми к передаче в функцию SendEmail).

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

GenEan(ID, Code) – Формирует штрих-код EAN 13 Состоящий из идентификатора типа сущности ID и кода сущности Code, Выравнивает до 13-ти символов, первый – «2», последний – контрольная сума.

CheckEan(s) - Проверяет строку s, что она является кодом EAN13.

SaveToFile(FileName,s, encoding [, append])- Создает текстовый файл по пути, указанному в FileName (если по указанному пути существует файл с указанным именем, он удаляется и создается новый) и производит запись строки s в созданный текстовый файл. encoding - название кодировки, по умолчанию сохраняет в кодировке ANSI. Доступные названия кодировок: KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Если append = true, то производится дописывание данных в файл, а не перезаписывание (не обязательный, по умолчанию выключен).

StrFromFile(FileName) - Читает файл FileName, возвращает в виде строки. При ошибке чтения вызывает ошибку.

DownloadAttachment(code, [savefilepath, tablename='attachment', fieldBlob='file', fieldLDtime='ldtime', fieldUID='uid']) - Функция выкачивает аттачмент из базы, по внутреннему коду - Code, всегда возвращает содержимое файла в виде строки, а также может сохранить файл по указанному пути в параметре savefilepath. По умолчанию, функция настроена на таблицу attachment. Code - внутренний код вложения, tablename - название таблицы, fieldBlob - название поля с содержимым файла, fieldLDtime - название поля с временем последнего изменения строки (для работы кэша). Функция использует кэш и умеет выкачивать файлы зауженные на внешние серверы (http, ftp,sftp, measoft). Для выкачивания с сервера measoft обязательно необходимо указывать параметр fieldUID.

DeleteFile(FileName) - Удаляет файл FileName с диска, возвращает истину, если операция прошла успешно и ложь - в противном случае.

HTTPPOST(host, PostParams, Proxy, ContentType, HTTPUser, HTTPPass, Method, CustomHeader, Reconnects) - Отправляет HTTP запрос по адресу host с данными PostParams. Proxy - объект Proxy, задающий прокси-сервер (по-умолчанию - пусто - не использовать прокси). ContentType - Заголовок ContentType. По-умолчанию - "application/x-www-form-urlencoded; Charset=UTF-8". HTTPUser и HTTPPass - данные для http-авторизации на сервере. Method - метод отправки запроса, по-умолчанию - "POST". CustomHeader - Дополнительные заголовки HTTP запроса, передается в виде списка параметров через запятую и всегда образуют пару: 1 параметр - название заголовка, 2 параметр - значение. Если значение содержит запятую то его нужно экранировать в двойные кавычки. Reconnects - Количество попыток подключения (по-умолчанию - 2), если больше 100 - это таймаут единственной попытки подключения в миллисекундах.
Функция возвращает ответ сервера. 
''Обратите внимание:'' Для имитации отправки данных html-формы методом POST может понадобиться перед передаваемыми параметрами добавить "Data=".

FTPPUT(host, User, Pass, FileName[, Active]) - Отправляет файл на FTP/SFTP-сервер. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

FTPGET(host, User, Pass, SourceFileName, DestFileName[, Active]) - Загружает файл SourceFileName с FTP/SFTP-сервера, сохраняет его в файл DestFileName. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

GetTempDir - Возвращает путь к временной папке.

ApplicationDir - Возвращает путь к файлу программы.

Interpretate(script) - Интерпретирует скрипт указанный в script. Выполнение происходит в текущем инстансе.

LastHttpError - Выводит последний запрос выполненный с ошибкой в функции HttpPost. Содержит подробную информацию по запросу и ответу.

LastHttpResponse - Выводит последний запрос и ответ от сервера после выполнения Http-запроса в функции HttpPost.

== Объект TExcel ==

Предназначен для доступа к данным документов MS Excel. Требует установленного приложения MS Excel. Для работы без установленного MS Excel предусмотрен объект TDirectExcel.

'''''Ввод данных'''''

LoadFromDB(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Если Headered истинно (по-умолчанию), таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Если TranslateHeader истинно, то заголовки таблицы будут автоматически переведены.

MyDB.Open('select * from kurier');
xl.LoadFromDB(MyDB.Self);
xl.DoNotDestroy(true);
xl.SetVisible(true);

Post2Sheet(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) - Почти полный аналог LoadFromDB. В отличии от LoadFromDB если есть открытый файл, выгрузка данных будет выполнена прямо в него.

OpenFile(aFileName) – Выполняет функции SetFileName и Open.

FileName – Возвращает имя текущего файла.

SetFileName(aFileName) – Задает значение свойства FileName.

Open - Открывает файл с именем, заданным свойством FileName. Если имя файла не задано - создает чистую книгу.

Close – Закрывает текущий файл.

'''''Ячейки'''''

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

Cell(x, y, text) – Возвращает значение ячейки, заданной координатами x, y. Необязательный булевый параметр text, в случае истинности, указывает на необходимость возврата данных с учетом формата ячейки, т.е. то, что пользователь видит на экране. Обратите внимание, что если в ячейке число, и ширина столбца не достаточна для отображения, Excel выводит "#####", что и будет возвращено программе, если text=ИСТИНА. Поэтому перед таким использованием рекомендуется выполнить функцию AutoFit.

SetCell(x, y, v[, x2, y2]) – Устанавливает значение ячейки, заданной координатами x и y, в значение v. Если заданы параметры x2, y2 - объединяет (merge) диапазон ячеек заданных координатами, устанавливает значение объединенной ячейки.

'''''Строки'''''

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

RowAutoFit([y1, y2]) - Устанавливает автоматическую высоту строк. Аргументы y1 и y2 необязательны и если не указаны, то процедура будет выполнена для всей страницы, в ином случае только для строк от y1 до y2.

SetRowHeight(r, h[, cnt]) – Устанавливает высоту cnt строк (по-умолчанию 1) начиная со строки r в h пикселей.

GetRowHeight(r) – Возвращает высоту строки r в пикселях.

RowInsert(i[, count]) - Вставляет count (по-умолчанию - 1) строк НАД строкой с номером i.

RowDelete(i[, count]) - Удаляет count (по-умолчанию - 1) строк начиная с номера i.

'''''Столбцы'''''

ColCount - Возвращает количество столбцов в листе.

AutoFit – Устанавливает автоматическую ширину столбцов.

ColumnDelete(i[, count]) - Удаляет count (по-умолчанию - 1) столбцов начиная с номера i.

SetColWidth (c, w) – Устанавливает ширину столбца c в w пикселей.

GetColWidth (c) – Возвращает ширину столбца c в пикселях.

'''''Листы'''''

SetSheet(No) – Устанавливает номер текущего листа. Если лист с таким номером не существует - он будет создан (и все листы до него). Нумерация начинается с 1.

SetSheetName(Name) - Устанавливает название текущего листа.

SheetsCount – Возвращает количество листов в книге.

CopySheetAfter([SheetFrom[, SheetAfter]]) - Копирует лист SheetFrom (по-умолчанию - текущий), создавая новый лист после листа SheetAfter (по-умолчанию - совпадает с копируемым).

SheetDelete(i) - Удаляет лист с номером i.

'''''Форматирование'''''

Align(x1, y1, x2, y2 [,HAlign, VAlign]) - Устанавливает выравнивание данных в указанном диапазоне. HAlign - горизонтальное выравнивание (0 – прижато влево , 1 – по центру , 2 – прижато вправо), VAlign - Вертикальное выравнивание (0 – прижато к верху , 1 – по центру , 2 – прижато к низу).

WrapText(x1, y1, x2, y2, value) – Устанавливает перенос текста прямоугольника в значение value. Если координаты опущены, или 0 – устанавливает границы всей используемой области. Для Value значение по-умолчанию - true.

NumberFormat(x1, y1, x2, y2, Format) - Устанавливает формат вывода чисел в указанном диапазоне ячеек. Например, если Format='0.00' - числа будут выводиться c обязательными 2 знаками после десятичного разделителя.

SetBorders(x1, y1, x2, y2) – Устанавливает границы прямоугольника. Если координаты опущены, или 0 – устанавливает границы всей используемой области.

SetFont(Font[, x1, y1[, x2, y2]]) - Устанавливает шрифт Font для ячеек диапазона. Можно указать координаты только одной ячейки, можно - вообще не указать, тогда будет использован последний выделенный диапазон. Шрифт задается как обычно: 'Arial, 16, T, T, T', порядок параметров: Имя шрифта, размер, жирное начертание, курсивное начертание, одиночное подчеркивание. Если параметры не заданы, то у текущего шрифта они меняться не будут. Примеры: SetFont('Arial, 10, T, F, F', 1,1) - в ячейке A1 будет установлен шрифт Arial жирным начертанием (не курсив и без подчеркивания). SetFont(', , , T, F', 2,1) - в ячейке B1 будет поменяется только начертание курсив и будет отменено подчеркивание (если оно было).

SaveValuesOnly - убирает формулы на текущей странице и оставляет лишь их результативные статичные значения.

'''''Цвета'''''

SetRowFontColor(Row,Color) - Устанавливает цвет шрифта в строке Row. Color - целое значение (RGB)

SetRowColor(Row,Color) - Устанавливает цвет фона в строке Row. Color - целое значение (RGB)

SetColumnFontColor(Col,Color) - Устанавливает цвет шрифта в столбце Col. Color - целое значение (RGB)

SetColumnColor(Col,Color) - Устанавливает цвет фона в столбце Col. Color - целое значение (RGB)

SetCellFontColor(Row,Col,Color) - Устанавливает цвет шрифта в ячейке с координатами [Row,Col]. Color - целое значение, равное номеру цвета в палитре (ColorIndex,не RGB)

SetCellColor(Row,Col,Color) - Устанавливает цвет фона в ячейке с координатами [Row,Col]. Color - целое значение (RGB)

GetRowFontColor(Row)- Возвращает RGB значение цвета шрифта строки Row

GetRowColor(Row)- Возвращает RGB значение цвета фона строки Row

GetColumnFontColor(Col)- Возвращает RGB значение цвета шрифта столбца Col

GetColumnColor(Col)- Возвращает RGB значение цвета фона столбца Col

GetCellFontColor(Row,Col) - Возвращает номер цвета шрифта в палитре (ColorIndex) в ячейке с координатами [Row,Col]

GetCellColor(Row,Col) - Возвращает RGB значение цвета фона в ячейке с координатами [Row,Col]

'''''Копи-паст'''''

Copy(x1, y1, x2, y2) - Копирует в буфер экселя

Cut(x1, y1, x2, y2) - Вырезает в буфер экселя

Paste(x1, y1) - Вставляет из буфера экселя. Команды copy-paste неразрывны, если что нибудь сделать в промежутке между ними, например вставить значение в ячейку, то копирование сброситься. (Последовательность использования: copy - paste, cut - paste)

PasteStyle(x1, x2, y1, y2) - Вставляет только оформление из буфера экселя (Последовательность использования: Copy - PasteStyle)

'''''Изображения'''''

InsertPicture(TPicture, [x=1, y=1, DispX=0, DispY=0, width=0, height=0]) - Функция вставляет рисунок на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки, width, height (не работает для DirectExcel) - ширина и высота области рисунка в пойнтах-единицах Excel

InsertFirmLogo(FirmCode, [x=1, y=1, DispX=0, DispY=0]) - Функция вставляет логотип фирмы с кодом FirmCode на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки.

'''''Вывод'''''

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки. Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SheetFitPageWidth - устанавливает режим масштабирования печати, чтобы печатная форма помещалась в ширину на один лист.

SetOrientation(value) - Устанавливает ориентацию страницы. True (по-умолчанию) - альбомная (ландшафтная), Ложь - портретная.

PrintOut([copies]) - Печатает текущий лист на принтере по умолчанию. Параметр copies - количество копий, по умолчанию равен 1.

Save(filename) - Сохраняет в файл filename. Если файл существует, в основной системе он будет перезаписан, в других проектах - вызовет ошибку "Файл уже существует".

SetVisible(b) – Устанавливает видимость приложения Excel для пользователя. По-умолчанию – false (не видимо).

DoNotDestroy(b) – При уничтожении объекта TExcel (а он уничтожается, как и все остальные объекты автоматически при завершении выполнения скрипта), приложение Excel уничтожается вместе с ним. DoNotDestroy(true) отключает уничтожение приложения.

'''''Пример использования'''''

new('TExcel', 'myxl');
myxl.OpenFile('c:\asdf.xlsx');
set($sum, 0);
while (myxl.EOF=0,
set($sum, $sum+int(myxl.c));
myxl.next );
$sum

''Возвращает сумму всех числовых данных столбца C файла 'c:\asdf.xlsx'''

== Объект TDirectExcel ==
Объект позволяет работать с файлами Excel напрямую, без установленного пакета MsOffice. Применяется в сервисах и при отсутствии экселя. Он максимально совместим с объектом TExcel, однако некоторые методы могут быть не реализованы.

== Объект TCSVFile ==
Предназначен для доступа к данным документов CSV. Разделителем столбцов является символ точка с запятой ;

Функции:

FileName – Возвращает имя текущего файла.

OpenFile(FileName) – Открывает файл FileName.

LoadFromDB(DB[, Headered=false]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO.

LoadFromText(s) - Загружает таблицу из строки s.

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки.

SaveToFile(Filename) - Сохраняет в файл с именем filename.

== Объект TADO ==

Предназначен для доступа к базам данных.

Функции:
{| class="wikitable"
!Функция
!Описание
|-
|Connect(ConnectionString)
|Подключает к источнику данных. ConnectionString – Строка подключения ADO.
|-
|ConnectMySQL(DBServer, DBPort, DBUser, DBPass, DBName)
|Подключает к базе данных MySQL.
|-
|Open(Query)
|Открывает набор данных выполнив запрос Query.
|-
|FieldByNo(i)
|Возвращает значение поля с номером i. Нумерация полей – с нуля.
|-
|FieldName(i)
|Возвращает имя поля с номером i.
|-
|FieldCount
|Возвращает количество полей.
|-
|RecordCount
|Возвращает количество записей.
|-
|RecNo
|Возвращает номер текущей записи. ''ВНИМАНИЕ! В зависимости от способа подключения к БД нумерация может начинаться как с 0 так и с 1!''
|-
|EOF
|Возвращает признак достижения конца набора данных. Становится истиной когда выполняется команда Next на последней записи.
|-
|Next
|Переход на следующую запись набора.
|-
|First
|Переход на первую запись набора.
|-
|Last
|Переход на последнюю запись набора.
|-
|FieldByName(FieldName)
|Возвращает значение поля по имени. Также возможно указание имени поля как свойства объекта.
|-
|Field(Table, ID, FieldName)
|Возвращает значение поля FieldName записи с кодом ID таблицы Table. Набор данных, если он открыт, при этом не закрывается. Первичный ключ таблицы должен называться «code». Гарантированно работает только с MYSQL!!!
|-
|GetSQLValue(Query)
|Выполняет SQL-запрос. Текст запроса должен начинаться с первого символа строки (перед запросом не должно быть пробелов, переносов строк, комментариев и т.д.). Если запрос Insert – возвращает ID вставленной записи. Если запрос – Update, Delete, Replace, Set, Start, Commit, Rollback – возвращает количество измененных записей (RowsAffected), иначе – Select – значение первого поля первой строки результата как текст.
|-
|FillText(s)
|Возвращает строку s с замененными названиями полей между знаками процента на соответствующие значения текущей записи. Так же в строке возможно использование интерпретируемого кода, заключенного между тегами "<?>" и ">". При интерпретации система сначала производит замену полей с процентами на значения, потом интерпретирует код. ''Внимание! Функция не создает отельный контекст интерпретатора, а использует существующий, в нем доступны все объекты и переменные, вызывающего скрипта.'' Дополнительно автоматически создается объект TSelfADO, подключенный к той же БД, что и контекст, вызвавший функцию, с пустым именем, а так же с именем "dataset".
|-
|Query(Query)
|Синоним GetSQLValue.
|-
|Close
|Закрывает набор данных.
|-
|Self
|Возвращает указатель на подключение к БД для использования в других объектах.
|-
|ParseForIn([FieldName='code'])
|Возвращает через запятую значения всех строк в указанном столбце. По умолчанию, используется столбец с именем code.
|-
|GetSQL
|Для отладки. Возвращает последний SQL запрос переданный в методы Open, Query, GetSQLValue
|-
|ExportExcel
|Для отладки. Выгружает в эксель содержимое датасета. Можно использовать в незнакомом окружении для понимания передаваемых полей в : шаблонах, печатных формах и т.д. Аналог команды %echo% в шаблонах, на случай если она не сработает.
|-
|OnGetText
|Функция подменяет текстовый вывод значения поля при выгрузке в эксель. Первый параметр это имя поля, которое надо подменить. Второй параметр это то что необходимо вывести. Работает только с текстовыми полями.
'''''Пример использования'''''
DB.OnGetText('Зона', IF((DB.FieldByName('-Lat') ! 0) * (DB.FieldByName('-Lon') ! 0),
GetPolygonByLatLon(DB.FieldByName('-Lat'), DB.FieldByName('-Lon'), 'TYPE = 1 AND IFNULL(zone, 0) > 0 AND PRICE = ' + DB.FieldByName('-price'), 'zone')
,
''
));
|}

Пример использования – см. TSelfADO

== Объект TSelfADO ==

Наследник объекта TADO. Служит для подключения к «родной» для программы, в которой выполняется скрипт, базе данных. Обладает всеми свойствами и методами объекта TADO, кроме Connect. Иногда автоматически создается системой для обеспечения простого доступа к базе данных, а также иногда создается системой с уже открытым набором данных для передачи обрабатываемого системой набора данных в скрипт. В этом случае для скрипта недоступны функции Open и Close.

Пример использования:

rem('Копируем данные из "родной" базы данных в базу MSSQL.');
new('TSelfADO', 'MyDB');
new('TADO', 'MSSQL');
MSSQL.Connect('Provider=SQLOLEDB.1;Password=myPassword;Persist Security Info=True;User ID=myUsername;Initial Catalog=myDataBase;Data Source=myServerAddress');
MyDB.Open('select code, name, passport from kurier where code>'+Int(MSSQL.Query('select max(code) from kurier'))+' order by code');
While(MyDB.EOF=0,
MSSQL.Query('insert kurier (code, name, passport) VALUES ('+MyDB.Code+', '+QuotedStr(MyDB.Name)+', '+QuotedStr(MyDB.Passport)+')');
MyDB.Next;
);

== Объект TPrinter ==

Предназначен для доступа к принтерам.

Функции:

BeginDoc – Начинает новый документ.

EndDoc – Закрывает документ

PageHeight – Возвращает высоту страницы в пикселях

PageWidth – Возвращает ширину страницы в пикселях

PageNumber – Возвращает номер текущей страницы документа

Orientation – Возвращает текущую ориентацию страницы (0 – портретная, 1 – ландшафтная)

Printing – Возвращает истину если документ открыт

SetOrientation(Orientation) – Устанавливает ориентацию страницы. При необходимости начинает новый документ, новую страницу.

ShowDialog – Показывает пользовательский диалог печати. Возвращает истину, если пользователь нажал "OK".

NewPage – Начинает новую страницу

Canvas – Предоставляет доступ к объекту TCanvas, связанному с принтером.

PrinterNames – Возвращает список принтеров, установленных в системе, разделенный переносами строк

PrintersCount – Возвращает количество установленных в системе принтеров

SetPrinter(Printer) – Устанавливает текущий принтер. Если передана строка – ищет принтер по названию, иначе – по номеру. Нумерация начинается с 0.

PrintTable(Y, Table) – Выводит на печать таблицу Table типа TTable, начиная с координаты Y. При необходимости таблица печатается на нескольких страницах. Возвращает координату Y конца таблицы.

GetDefaultPrinter - Возвращает имя текущего активного принтера.

SetDefaultPrinter(Printer) – Запоминает предыдущий активный принтер и устанавливает новый текущий принтер. Printer - имя принтера. При необходимости нескольких последовательных вызовов SetDefaultPrinter рекомендуется между вызовами использовать RestoreDefaultPrinter.

RestoreDefaultPrinter - Устанавливает активным принтер, который был текущим перед последним вызовом SetDefaultPrinter.

== Объект TCanvas ==

Предоставляет доступ к холсту объекта для прорисовки изображения.

Функции:

DPIX – Возвращает разрешение холста по горизонтали в точках на дюйм

DPIY – Возвращает разрешение холста по вертикали в точках на дюйм

TextOut(x, y, s[, x1, y1, x2, y2]) – Выводит строку s начиная с точки с координатами x и y. Если указаны параметры x1, y1, x2, y2 – то выводимый текст ограничивается заданным прямоугольником.

TextOutEx(x1, y1, x2, y2, Alignment, Font, s, Indent) – Выводит строку s в прямоугольнике с координатами x1, y1, x2, y2. По горизонтали строка выравнивается в соответствии с Alignment (0 – прижато влево, 1 – вправо, 2 – по центру), по вертикали выравнивается по центру. Используя шрифт Font (см описание ниже). Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату X фактического окончания текста (правой стороны – если строка прижата влево, и левой – в остальных случаях)

MLTextOut(x1, y1, x2, y2, Alignment, VAlignment, Font, s, Heigth, Indent) – Выводит многострочный текст s в прямоугольнике с координатами x1, y1, x2, y2 с переносом по словам. По горизонтали строки выравниваются в соответствии с Alignment, по вертикали – в соответствии с VAlignment (0 – прижато вверх, 1 – по центру, 2 – прижато вниз). Используя шрифт Font (см описание ниже). Heigth – высота строки. Если опущено или равно нулю – высота определяется автоматически в соответствии с выбранным шрифтом. Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату Y фактического окончания текста (нижней границы последней строки текста. ''ВНИМАНИЕ! Функция использует координаты прямоугольника для позиционирования текста, однако она не ограничивает его верхней и нижней границами этого прямоугольника!''

DrawPic(x1, y1, x2, y2, Pic, Style, Alignment, Mode) – Прорисовывает изображение Pic (ссылка на изображение TPicture.Self) в прямоугольник заданный координатами x1-y2. Style – стиль масштабирования. 0 – растянуть изображение до границ прямоугольника не сохраняя пропорции, 1 – вписать изображение в прямоугольник сохраняя пропорции – вероятно, останутся поля по вертикали или горизонтали, 2 – вписать сохраняя пропорции, обрезав при необходимости изображение по вертикали или горизонтали. Alignment – выравнивание по горизонтали. Работает только в случае если style=1 и при растягивании изображения получились вертикальные поля. 0 – разместить по центру, 1 – прижать влево, 2 – прижать вправо. Функция возвращает координату X правой стороны изображения кроме случая, когда Style=1 и Alignment=2 – в этом случае возвращается координата левой стороны изображения. Mode - способ наложения изображения. 0 (по-умолчанию) - копирование как есть. 1 - Наложение операцией AND (применяется для получения эффекта прозрачности изображения), 2 - наложение операцией XOR (Применяется для возможности повторной операцией убрать изображение), 3 - Наложение операцией OR.

FillRect(x1, y1, x2, y2) – Рисует прямоугольник '''без границ''' и закрашивает цветом BrashColor

Rect(x1, y1, x2, y2) – Рисует прямоугольник '''c границами''', задаваемыми текущим пером, и закрашивает цветом BrashColor

SetFont(Font) – Устанавливает шрифт по-умолчанию.

SetPen(Width, Color) - Устанавливает параметры "ручки" - толщину и цвет. Если любой параметр опустить, соответствующее значение не будет изменено.

SetBrush(Color, Style) - Устанавливает параметры заливки - цвет и стиль. Если любой параметр опустить, соответствующее значение не будет изменено. Стили заливки: 0 - сплошная, 1 - отсутствует (прозрачная), 2-7 - различные виды штриховки (горизонтальные, вертикальные, в клеточку и т.д.).

TextHeight(s) – Возвращает высоту текста s в пикселях без учета многострочности, с учетом текущего шрифта.

TextWidth(s) – Возвращает ширину текста s в пикселях без учета многострочности, с учетом текущего шрифта.

Использование шрифта (Font): У объекта TCanvas есть «глобальные» установки шрифта. Однако для некоторых функций возможно указание шрифта, отличающегося от глобального. Параметры шрифта – это текстовая строка, состоящая из 6-ти параметров, разделенных запятыми: Название, размер, жирный, курсив, подчеркнутый, цвет. Например:

'Times New Roman, 8, Y, N, N, 255'

Любой параметр можно опустить, и тогда вместо него будет использовано значение по-умолчанию: шрифт: arial, размер – 10, не жирный, не курсив, не подчеркнутый, цвет – черный. Например: ', 7' – указывает, что по-умолчанию нужно взять все параметры кроме размера шрифта. Также можно вместо всей строки указать тире ('-') или пустую строку, и шрифт будет использоваться «глобальный».

Объект можно создать отдельно, не создавая объект TPrinter. В таком случае объект создастся как ссылка на текущий холст принтера (принтер должен быть запущен и начат новый документ). Такой подход используется в доп. возможности PrintCustomSticker

== Объект TPicture ==

Предоставляет функции для работы с графическими изображениями форматов BMP, GIF, JPEG и PNG, а также для формирования штрих-кодов. Обратите внимание, прозрачность изображений не поддерживается, однако в методе TCanvas.DrawPic есть параметр Mode, призванный создавать эффект прозрачности.

Функции:

LoadFromFile(FileName) – Загружает изображение из файла FileName. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromDB(DB, Query) – Загружает изображение из базы данных. DB – ссылка на подключение к базе данных TADO.Self, Query – текст запроса. Запрос должен вернуть в первом поле первой строки BLOB-поле с изображением, все остальные данные возвращаемые запросом игнорируются. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromStr($s) – Загружает изображение из строки $s. Возвращает истину, если операция прошла успешно, иначе – ложь.

CreateBar(Width, Height, BarCode, Textless, Type) – Формирует штрих-код шириной Width и высотой Height с типом кодирования Type. BarCode – текст штрих-кода. Булево значение Textless указывает, что в штрих-коде не должно быть человеко-читаемых символов если истинно. Type указывает тип кодирования: 0 (по-умолчанию) CODE128, 1 - EAN-13, 2 - Interleaved 2-5, 3-DataMatrix, 4-QRCode.
Штрихкод должен быть: Для EAN-13 цифровым 12 или 13 символов (13-й, контрольная сумма рассчитывается автоматически), для CODE128 - должен иметь состоять из допустимого для этого кодирования набора символов. Для Interleaved - должен состоять из четного числа цифр, контрольная сумма автоматически не рассчитывается. Если для Interleaved кода указано значение из 14-ти знаков, подпись цифр выводится в формате Почты России.
Внимание! Для кодов EAN-13 и Interleaved ширина штрих-кода Width не является точным значением получаемого на выходе изображения. Ширина изображения рассчитывается как максимальное кратное минимально возможной ширине, но не меньше минимально возможной. Конечную ширину можно получить в соответствующем свойстве объекта. Для кода CODE128 штрих-код на выходе может оказаться пустым, если указанной ширины штрих-кода не достаточно для его формирования.
Для кода DataMatrix можно установить режим для печати скрытых символов с кодами 29(GS) и 232(FCN1), которые требуются для формирования Честного Знака. Для этого необходимо в начале строки указать символ "[" и все разделители 01, 21, 91, 92 так же экранировать этими скобками. Должно получиться [01]02900002317701[21]k3LInNbH_oG0Q[91]EE06[92]YXiyKfiHjE4YE8b+YVMC1O5r8VtpplA3AwcCqrcG9Dk= . При формировании кода, включится режим формирования штрих-кода DataMatrix GS1, в начале будет добавлен символ с кодом 232 (FCN1), а потом будут добавлены разделители с кодом 29 (GS)
Функция возвращает 1 в случае успеха, или текст ошибки, если такая произошла.

SetSize(Width, Height) - Устанавливает размер изображения.

AsString([ImageFormat]) - Возвращает изображение в виде строки с двоичными данными. ImageFormat принимает значения 1 - Bitmap (по-умолчанию), 2 - jpeg, 3 - png, 4 - gif.

Width – Возвращает ширину изображения.

Height – Возвращает высоту изображения.

Rotate(Angle) – Поворачивает изображение по часовой стрелке на угол Angle. Угол указывается в градусах и может принимать любые значения.

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

Canvas - ссылка на объект TCanvas холста изображения.

== Объект TTable ==

Предоставляет функции для работы с таблицами. Удобен для печати таблицы на принтере. Алгоритм таков: Загружаем датасет в таблицу, настраиваем ее (шрифты, штрих-коды и т.д.), потом выводим на принтер функцией TPrinter.PrintTable.

Функции:

LoadFromDB(DB) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Заголовок – это первая строка таблицы.

Cell(С, R) – Возвращает значение ячейки таблицы с координатами (C, R). Нумерация строк и столбцов начинается с 1.

SetCell(С, R, Value) – Устанавливает значение ячейки таблицы с координатами (C, R) в Value. Нумерация строк и столбцов начинается с 1.

RowCount – Возвращает количество строк в таблице.

ColCount – Возвращает количество столбцов в таблице.

SetTitleFont(Font) – Задает шрифт заголовка таблицы (первой строки).

SetFont(Font) – Задает шрифт всей таблицы кроме заголовка.

SetColFont(C, Font) - Устанавливает шрифт столбца C.

SetIndent(Indent) – Задает отступ от границы ячейки до текста в процентах от ширины страницы. По-умолчанию значение 0.3

SetWidth(С, Width) – Задает значение ширины столбца C в процентах от ширины страницы.

SetMinRowHeght (Heght) – Задает значение минимальной высоты строки в пикселях.

SetBarCode(Col, Type) - Указывает, что данные из столбца Col должны печататься в виде штрих-кода. Тип штрих-кода - Type. Значение '''"1" - EAN13'''. Для кода EAN13 первая строка данных в ячейке должна иметь вид "тип штрих-кода, номер", например "7, 123" (без кавычек, конечно). В этом случае система сформирует штрих-код: "2700000001233". Первая цифра - всегда 2, далее - указанный тип штрих-кода, нули, чтобы получилось 13 символов, номер, указанный в таблице, и один символ - контрольная сумма. Значение '''"2" - CODE128''' (с версии 734). Данные из первой строки ячейки таблицы печатаются в штрих-коде "как есть". Для всех видов штрих-кода (с версии 734) последующие строки печатаются под штрих-кодом в виде текста.

SetMultiHeader(Active) - Включает печать заголовка при переносе таблицы на несколько страниц. По умолчанию отключено.

SetCustomHeader(script) - Включает печать пользовательского заголовка. Script - это код интерпретатора, который должен печатать заголовок на канву. Печать таблицы может происходить на нескольких листах, по этому скрипт будет вызван для каждого листа. При использовании этого метода, автоматически инициализируются переменные: $TablePageNo - номер страницы, нумерация начинается с нуля; $TableY - координата по оси Y, от которой рисуется заголовок. Чтобы таблица была под заголовком необходимо значение переменной $TableY увеличить на высоту заголовка.

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

Пример:
<?>
NEW('TPrinter', 'Prn');
If(prn.ShowDialog,
NEW('TTable', 'Tbl');
NEW('TSelfADO', 'MyDB');
MyDB.Open('SELECT concat("7", ", ", a.code, "\r\n", a.client_id, "\r\n", a.zakaz, "-", a.number) as "Штрих-код", a.target AS "Заказик", address, phone, vlog, poruch FROM address a order by code desc limit 10');
Tbl.LoadFromDB(MyDB.Self);
Tbl.SetBarcode(1, 1);
Tbl.SetCustomHeader(
if($TablePageNo>0,
Prn.Canvas.TextOut(Prn.Canvas.DPIX*0.1, $TableY, 'Продолжение таблицы');
set($TableY, $TableY + Prn.Canvas.TextHeight('H'));
,0)
);
Prn.BeginDoc;
Prn.PrintTable(0, Tbl.Self);
Prn.EndDoc
, );

== Объект TBaseUtils ==

Предоставляет функции, базирующиеся на БД системы «MEASOFT». По-умолчанию, при создании подключается к основной базе данных модуля, в котором выполняется скрипт, если такая определена контекстом, однако это можно изменить, см SetConnection.

Функции:

'''MakeAddress(s[,town])''' – возвращает значение, полученное путем преобразований адреса s для приведения его к внутреннему формату программы. В процессе преобразования до нескольких раз происходит замена буквосочетаний по таблице замены (ее редактирование доступно по нажатию кнопки «Автозамена» в интерфейсе импорта БД из Excel системы (см. Руководство пользователя)), поиск улиц по базе КЛАДР с точностью до одного знака, и некоторые другие операции, нацеленные на исправление ошибок в написании адреса.

С версии программы 2008.0.0.615, при вызове функции в формулах загрузки реестра, в первую очередь происходит проверка строки s на условия:
* в строке s записано число;
* строка s начинается с "ПВЗ ".
Если одно из этих условий выполняется, то функция пытается установить пункт самовывоза - т.е она сама в загружаемой карточке корреспонденции укажет: адрес ПВЗ, город ПВЗ и установит галку самовывоз. Правила поиска ПВЗ:
* Если s число - считаем его внутренним кодом филиала;
* Если s начинается с "ПВЗ " - Например в адресе передана строка "ПВЗ На Ленинском проспекте", то искать будем филиал с названием "На Ленинском проспекте" который подчиненный, активный, с галкой ПВЗ и в городе town. Если город не указан, то ищем филиал во всех городах, и считаем его найденным если найдем только один филиал.
* Если филиалы найти не удалось, функция makeaddress работает как обычно и выполняет преобразование адреса.

Если адрес не содержит русских букв, только латиница, и курьерская служба находится в одной из стран Россия, Белоруссия, Казахстан или Украина, и город-получатель (второй параметр, town) находится так же в одной из этих стран, функция автоматически делает транслитерацию адреса на русский язык.

''SetConnection(DB) – Подключает объект к базе данных DB, где DB – ссылка на объект TADO.Self.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

''SetTown(Town) – Устанавливает код текущего города (используется в некоторых функциях объекта) в значение Town. По-умолчанию текущий город – 1.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

'''SetIndexLength(Length)''' – Устанавливает длину почтового индекса. По-умолчанию – 6.

'''GetIndex(Address)''' – Возвращает почтовый индекс из адреса.

'''GetStreet(Address)''' - Возвращает улицу до первой запятой.

'''GetHome(Address)''' - Возвращает номер дома до второй запятой, но не более пяти символов.

'''GetKurierByStation(station, Mass, Cash, Date_Putn)'''

'''TownByIndex(Index[, PriorityName][, PriorityCountry])''' – Возвращает код города по индексу. В случае ошибки поиска – код текущего города. Если нашлось несколько населенных пунктов, и указано приоритетное название - выбирается населенный пункт, название которого начинается с PriorityName (если есть).

'''TownByName(Name[,NotNeedCL=False, City=0])''' – Возвращает код города по имени. В случае ошибки поиска – возвратит код текущего города. Если параметр NotNeedCL (параметр не обязательный) установить в TRUE, тогда функция возвратит 0, если город не удалось найти. Параметр City (код региона) позволяет ограничить поиск одной областью (не обязательный, по умолчанию не используется).

'''FillClientInfo(Excel, client, Sheet, Row, Col)''' – Выводит в эксель информацию о клиенте с кодом client на лист sheet начиная со строки row и столбца col.

'''SavePrintFormToFile(FormType, FormNumber)''' - Сохраняет на диске файл печатной формы и возвращает путь к нему

'''CreateTrans(Address[, Store][, Operator][,Correction])''' - Формирует запись для печати кассового чека для корреспонденции с кодом Address, для выбора кассового аппарата используется код склада Store. Если Store не указано - при исполнении в среде клиентского модуля системы использует склад, указанный пользователем в окне [[Настройка параметров рабочего места|"Настройка" - "Параметры"]], в остальных модулях - код текущего склада из [[Настройка глобальных параметров|переменной]] "CL" ("Текущий филиал"). Поле Operator позволяет указать кассира (передается код справочника сотрудников). Если не указан, в основной системе будет использован код авторизованного пользователя, в других модулях - 1.
Поле Correction позволяет указать данные для корректировочного чека, используется в системе Штрих-М. По умолчанию пустая строка. Возвращает идентификаторы записей чеков. Может вернуть пустую строку, если чек создавать не понадобилось, один или несколько кодов через запятую, если создано несколько чеков. В случае ошибки вызывает ошибку, поэтому рекомендуется использовать с функцией Try.

'''CreateReturnTrans(Address)''' - формирует запись для печати чека возврата для корреспонденции с кодом Address. Чек возврата печатается на полную сумму и с теми же атрибутами, что и чек продажи. Возвращает идентификатор записи чека возврата. В случае ошибки вызывает ошибку, поэтому, как и с CreateTrans, рекомендуется использовать с функцией Try.

'''CalcTownDeliveryDays(Source, Mode, TownTo, TownFrom)''' - возвращает количество дней необходимых на доставку отправления, только для межгорода. Source - код клиента, Mode - режим срочности, TownFrom - код города отправителя, TownTo - код города получателя.

'''CalcDeliveryDate(Source, Mode, TownTo, TownFrom, Date_Beg, Time_beg)''' - Возвращает планируемую дату доставки с учетом сроков доставки. Работает при городской и междугородней доставке. Для межгорода сроки доставки берутся из зон. Для городской доставки, из дополнительных параметров статуса (17 статус, 1 параметр в доп. информации) Если рассчитать дату планируемой доставки не удалось, возвращает пустую строку. Параметры: Source - код клиента, Mode - режим срочности, TownTo - город получатель, TownFrom - город отправитель, date_beg - дата заказа (может быть передана строкой в формате DD.MM.YYYY или в числовом), time_beg - время заказа.

'''GenSpecialSMA(DirectExcel, Code)''' - функция для генерации отчета о доставке по акту передачи денег. Первый параметр - указатель на TDirectExcel, второй параметр - код акта передачи денег. АПД выводится на текущий лист объекта TDirectExcel.

'''CreateSpecialSMA(ClientCode, DateTo)''' - Функция создает исходящий акт передачи денег (АПД). Требует ClientCode - код клиента, DateTo - дату акта. Функция возвращает коды созданных актов. Если возвращаемых параметров два, значит функция пыталась создать два АПД: первым, идет код АПД с наличной оплатой, а вторым с безналичной. Примеры возвращаемого результата: '0'- акт не был создан, отсутствуют корреспонденции; '124' - код созданного акта; '0,0' - пытались создать два акта, но отсутствуют данные; '4556,0' - создан только наличный АПД; '0,445' - создан только безнал.; '4556,445' - созданы нал. и безнал.

'''CreateAddressForActDelivery(ActCode, [DeliveryDateMode=0, Delivery=True])''' - Функция создает корреспонденцию на доставку акта. ActCode - код акта; DeliveryDateMode: 0 - установить план. дату доставки текущим рабочим днем, 1 - установить план. дату доставки следующим рабочим днем, 2 - установить план. дату доставки равной планируемой дате оплаты АПД; Delivery - создать корр. на доставку АПД или создать корреспонденцию на забор АПД (по умолчанию, доставка АПД). Работа функции может быть изменена системной доп. возможностью OnCreateAddressForActDelivery.

'''CreateAddressTransferAct(ClientCode, Store, DateTo, [AdditionalParam])''' - Функция создает исходящий акт передачи корреспонденции (АПК). Требует ClientCode - код клиента, Store - код филиала, для которого будет создан акт, DateTo - дату, до которой в акт попадут возвраты, AdditionalParam - дополнительный строковый параметр для передачи в системную доп. возможность ExceptionsForAPK, позволяющий отобрать в акт, например, только полные возвраты. Возвращает код созданного акта. ВНИМАНИЕ: при создании АПК используется системная функция ExceptionsForAPK. Если в ней используются интерактивные функции (вывод сообщений, диалоговые окна, выполнение скриптов), то акт сформирован не будет, а функция CREATEADDRESSTRANSFERACT вернет ошибку.

'''GetPolygonByAddress(Address, TownCode, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попал адрес. Если полигон найти не удалось, функция возвратит пустую строку. Address - адрес корреспонденции текстом; TownCode - код города; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByAddress(addressrecord.address, if((addressrecord.number=0)*(addressrecord.strbarcode=<nowiki>''</nowiki>), addressrecord.townfrom, addressrecord.townto), '`schema`=1') - пытаемся найти вхождение адреса в полигоны 1 схемы, при выборе города учитывается корр. на забор, у нее нужно использовать город-отправитель (а для обычной корр. нужен город-получатель).

'''GetPolygonByLatLon(Lat, Lon, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попали GPS координаты. Если полигон найти не удалось, функция возвратит пустую строку. Lat - широта текстом; Lon - долгота текстом; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByLatLon('55.769064','37.590713','zone is not null and price=0') - пытаемся найти вхождение координат в полигоны, где задана зона, для всех клиентских и курьерских зон.

'''GetLatLonByAddress(AddressText, TownCode)''' - возвращает географические координаты вида lat,lon указанного в AddressText адреса. Поиск производится в городе, имеющем код TownCode в таблице Town.

'''GetRouteCode(AddressText, TownCode, LatLon[, Lon])''' - для адреса AddressText в городе с кодом TownCode (из таблицы Town) по географическим координатам lat, lon возвращает код роута (записи, хранящей координаты адреса в городе). Если роут не найден (для адреса в городе не найдено записи с указанными координатами) - создает новый роут и возвращает его код, если роут найден (был создан ранее) - обновляет у роута координаты. Если параметр Lon задан, то параметр LatLon должен содержать одну координату, иначе LatLon должен содержать строку вида 'lat, lon'.
В случае ошибки возвращает Null.

Пример: 
Set($res, GetRouteCode(address, townto, '55.114034, 36.592397')); 
Set($res, GetRouteCode('Троицк, Полковника милиции Курочкина ул., 11', 1, '37.467446, 55.740537')); 
Set($res, GetRouteCode('Обнинск, Маркса пр., 20', TownByName('Обнинск'), 55.114034, 36.592397));

'''CalcAgentPrice(AddressCode, AgentCode, TownFrom, TownTo, Mode, [, Count=1])''' - функция возвращает стоимость доставки рассчитанную по тарифу агента. AddressCode - код адреса, AgenCode - код филиала (агента), TownFrom - код города отправителя, TownTo - код города получателя, Mode - режим срочности, count - тарифная сетку от указанного количества отправлений (по умолчанию 1)

'''SetAddrKol_vo(address, getkol_vo)''' - функция делает прием корреспонденции в текущем ответственном филиале. address - внутренний код адреса, getkol_vo - количество принимаемых мест, может принимать значения: "kol_vo" - принять все места, "getKol_vo+1" - принять еще одно место, "число" - сделать количество принятых мест равным указанному числу.

'''CalcClientCnt(client_code, date, is_intown [, date_put=CurrDate(), skipajust=false])''' - функция расчета количество доставленных корреспонденций у клиента с кодом client_code за предыдущий месяц от даты date (Или за текущий месяц, подробнее смотри переменную UseCurrentMonthCount) среди внутригородских (is_intown = true) либо междугородних (is_intown = false) корреспонденций, date_put - дата доставки (для альтернативного способа подсчета, включаемого переменной UseDatePutForCalcCnt), skipajust - не учитывать принудительно введенные количества (таблица priceclientadjust типы записей 0 и 1).

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset._self".
Описание некоторых полей датасета:
pmoney - процент от суммы;
pmoneycard - процент от суммы при оплате картой;
pricecode - код прайса (таблица Price) ;
distarea - район метро получателя (актуально при отключённом едином районировании, как правило район от 200 до 299 является признаком области);
region - признак области при включенном едином районировании;
distareaFrom и regionFrom - аналог distarea, region только для отправителя;
pcncode - код записи таблицы pricecnt "количество от";
Запрос содержит поля таблицы pricelinesnew - начальная стоимость по тарифной сетки, найденные без учета массы,только по типу срочности и режиму.
Запрос содержит поля таблицы price.

*addressrecord - ссылка на объектную модель карточки корреспонденции, следует использовать уже созданную addressrecord._self
*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*type - тип корреспонденции;
*mode - режим доставки;
*wait - количество минут ожидания (не учитывается при доп. услугах, есть системная услуга "ожидание");
*mass - масса отправления;
*rur - сумма передаваемых денег (не учитывается при доп. услугах, есть системная услуга "процент от суммы");
*inshprice - сумма страховки (не учитывается при доп. услугах, есть системная услуга "процент от объявленной стоимости");
*distance - расстояние до места доставки, обычно поле заполняется при доставке в область (регион в едино районировании). Дополнительная наценка к стоимости доставки;
*forward - направление доставки: true - туда; false - обратно;
*Collection - признак заборной корреспонденции: true - забор, false - доставка (В тарифе есть возможность указать стоимость для забора);
*TownFrom - код города отправителя;
*TownTo - код города получателя.

В тарифе есть возможность указать формулу, которая может влиять на базовый расчет. Формула может объявить служебные переменные, которые:
*$FormulaReplace - если true – возвращаемое значение полностью заменяет базовый расчет;
*$FormulaKoeff - коэффициент на который будет помножена базовая стоимость.
Также внутри формулы объявлены следующие объекты dataset, addressrecord и переменные:
*$ForceIntown - Переменная становится истиной, если междугородний расчет был отменен, т.к. адрес попал в нарисованную зону на карте.
*а также: $forward, $distance, $Count, $Collection, $Wait, $FormulaKoeff, $PriceCode - описание есть выше.

Для направления "туда", Функция GetBasePrice вызывается через доп. услугу "База" (при включенных доп. услугах), для направления "Обратно" всегда вызывается напрямую (т.к. доп. услуги работают только в для направления "туда").
На расчет этой функции влияют следующие переменные: "Финансы" -> "Расчет стоимости по адресу", "Финансы" -> "Зона клиента по умолчанию", "Финансы" -> "Подсчет кол-ва отправлений за месяц".

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset.self".

*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*tp - тип корреспонденции;
*mode - режим доставки;
*mass - масса отправления;
*TownFrom - код города отправителя;
*TownTo - код города получателя.

'''CalcAddressPrice(AddressCode, [,ZakazCount])''' - полностью пересчитывает стоимость доставки корреспонденции по тарифу клиента. AddressCode - внутренний код адреса, ZakazCount - не обязательный параметр, кол-во заказов от клиента.

'''GetStationCode(s [,town])''' – возвращает код станции метро, ассоциированный в системе с адресом s. В случае невозможности идентифицировать станцию метро – возвращает 0.
Когда включено районирование по карте, необходим второй параметр "town" - код города в котором нужно искать адрес. Возвращает код района если удалось его найти; код станции меж-города - если адрес удалось геокодировать, но район не нашли; код 0 - когда не удалось геокодировать адрес.

'''RecalcSpecialSMA(ActCode)''' - пересчитать акт передачи денег (АПД). Также, у корреспонденций входящих в АПД будет пересчитана стоимость доставки. Для Входящего АПД сумма акта не пересчитывается. Параметр ActCode - внутренний код акта, коды можно перечислять через запятую.

'''UserCode''' - Возвращает код текущего пользователя из таблицы «Пользователи» (users).

'''UserName''' - Возвращает имя текущего пользователя из таблицы «Пользователи» (users).

'''UserPass''' - Возвращает пароль текущего пользователя.

'''UserBaseCode''' – Возвращает код текущего пользователя из таблицы «Сотрудники» (kurier).

'''UserEmail''' - Возвращает e-mail текущего пользователя.

'''CurrentTown''' – Возвращает код текущего города (из таблицы town).

'''CurrentCity''' – Возвращает код текущего региона (из таблицы city).

'''CurrentLocation''' – Возвращает код текущего филиала (из таблицы store).

'''FromEmailStr''' - строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

'''FillExcelDoc'''(Excel, Dataset, FormType, FormNumber,Print,[printer]) - Выполняет указанную печатную форму в объекте excel. Excel объект можно не указывать, тогда функция сама создаст объект экселя и разрушит его, полезно когда книгу
нужно распечатать или отправить по email (на листе данных в ячейке 1,1 укажите ключевое слово email). Dataset объект с данными для скрипта в печатной форме, может быть null. Dataset передавать можно так db.self, тогда переданный dataset внутри печатной формы будет доступен по имени dataset. Print - печатает книгу на принтере, после печати объект excel разрушается, при использовании параметра не указываете объект excel. Printer - имя принтера, на котором печатать (по умолчанию пустая строка, что означает "печатать на принтере по умолчанию"). Например:

new('TExcel', 'excel');
FillExcelDoc(excel.self, null, 12, 1);
excel.DoNotDestroy(true);
excel.SetVisible(true);
''Покажет эксель с выполненной печатной формой''

'''ValutaSign''' – Возвращает название валюты для суммы.

'''SendToMeasoft(xml)''' - Отправляет запрос в клиентское API Measoft. Автоматически добавляет начальный "<?xml version="1.0" encoding="utf-8"?>".

'''InsertFirmAtt(excel, sheet, firmcode)''' - Вставляем на лист эксель по коду фирмы: печать, подпись, подпись бухгалтера, логотип. Тэги <STAMP>, <DIR>, <BUH>, <LOGO> соответственно. После тега можно указать размеры изображения в символах Microsoft Excel. Формат записи: <STAMP> 16, 16

'''PreCalcSalary(kurier, addressCodes)''' - Рассчитывает предварительную зарплату. Kurier - код курьера, используется для определения тарифа. addressCodes - коды адресов, через запятую для которых необходимо посчитать зарплату. Результаты расчета будут записаны в таблицу kurierpaydetail, так как расчет предварительный то записи не будут прикреплены к конкретному начислению.

select a.code, kpd.price as "туда", kpd2.price as "обратно" from address a
left join kurierpaydetail kpd on kpd.sourcetable=3 and kpd.sourcecode=a.code and kpd.rectype = 1
left join kurierpaydetail kpd2 on kpd2.sourcetable=3 and kpd2.sourcecode=a.code and kpd2.rectype = 2
where a.code in (...)

'''CalcSalary(DateTo, [Filter=0, KurierCode = 0, ManagerCode = 0])''' - Полный расчет зарплаты курьерам. DateTo - дата до которой создается начисление. Условия отбора курьеров для начисления. Filter - роль сотрудника: 0 - Все, 1 - курьеры, 2 - менеджеры; KurierCode - код курьера, ограничить расчет зарплаты одним курьером;ManagerCode - код курьера, ограничить расчет зарплаты курьерами указанного менеджера. Внимание фильтры Filter, KurierCode и ManagerCode накладываются друг на друга. Результатом функции является SubSQL с информацией по созданным начислениям.
поля ответа: код курьера, код менеджера, начислено, бонусы, штрафы, аванс, итого;
select kurier, manager, profit, bonus, shtraf, prepay, total [union select ...]

'''SelDistAddr(s)''' – Возвращает строку для вставки в select запрос, для вывода поля с упрощенным адресом. Принимает один необязательный строковый параметр - алиас таблицы из которой будет упрощаться поле address, по умолчанию "a"

'''VoiceReadStr(str)''' – Озвучивает фразу str голосовым уведомлением доступными словами из базы. Может содержать тег "{break_off}" для того, чтобы сделать эту фразу не пропускаемой в очереди воспроизведения.

'''CalcStorageCost(ClientCodes, DateFrom, DateTo, NeedReport[, Store])''' – рассчитывает стоимость хранения на складе для выбранных клиентов (ClientCodes - коды клиентов через запятую), в период дат с DateFrom до DateTo, с прикреплением к корреспонденции отчета в зависимости от выставленного параметра NeedReport. Может содержать параметр Store - код филиала, по умолчанию пустой (расчет выполняется для всех филиалов). Возвращает коды созданных корреспонденций через запятую.

'''WriteOut(DocId, ItemId, Date, Cnt[, BC])''' – производит списание товара со склада. DocId - код (docs.code) документа списания, ItemId - код товара (item.code), Date - дата операции, Cnt - количество списываемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер. Если указан BC, то параметр ItemId игнорируется и поиск номенклатуры происходит исключительно по штрих-коду. В случае успеха, функция возвращает строку вида: код номенклатуры, списанное кол-во.

'''IncomePurch(DocId, ItemId, Date, Cnt[, BC, Location = CurrentLocation])''' – производит приход товара на склад. DocId - код (docs.code) приходной накладной, ItemId - код товара (item.code), Date - дата операции, Cnt - количество приходуемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер, Location - код склада (store.code). В случае успеха, функция возвращает строку вида: код номенклатуры, введенное кол-во.

'''CreateLedgerDoc(Date, Client, UserCode, Type[, ExtNumber, Message])''' - создает складской документ и возвращает код этого документа. Date - дата документа. Client - код клиента. UserCode - код пользователя, создавшего документ. Type - тип документа (statetype = 13). ExtNumber - номер у поставщика для документов прихода и расхода. Message - комментарий к документу. Последние два аргумента не обязательные и могут быть пустыми.

== Объект TINIFile ==

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

Функции:

IniParam(s[,section='common']) – Существует только если имя экземпляра объекта пустое. Возвращает значение параметра s ini-файла секции «common», изменить секцию можно не обязательным параметром section. В случае отсутствия параметра в файле возвращает пустую строку.

Param(s) – Синоним IniParam с тем отличием, что существует только если имя объекта непустое.

SetText(s) - Загружает ini файл из строки s. Если в файле нет секции «common», то принудительно объявляет ее в начале.

== Объект TSMS ==

Предназначен для отправки SMS, а также проверки статуса их доставки.

Функции:

SetProxy(Server, Port, User, Pass) - Устанавливает настройки прокси-сервера.

Connect(Provider, Host, User, Pass, SenderName, SMSPrefix) – Подключает объект к провайдеру provider, используя адрес Host, имя пользователя User и пароль Pass. Значение SMSPrefix предназначено для того, чтобы провайдер мог различить сообщения от разных филиалов, если этими филиалами используется одно подключение. Если необходимости разделять сообщения нет - значение SMSPrefix можно не указывать.
Для провайдера доступны значения 'mirsms', 'sms16', 'websms', 'epochta', 'zanzara', 'SMSManager', 'f1sms', 'BitCall', 'mirsmsGET', 'AMD' и другие, либо можно указать числовые значения номера протокола, от 1 до <rspoiler text="20">Набор провайдеров все время дополняется, количество и номера можно смотреть в Справочники - Переменные - Подключения - SMS</rspoiler> соответственно. Эти значения соответствуют значениям переменной SMSProtocol таблицы "Value".

SendSMS(Phone, Text, [ID]) – Отправляет SMS с текстом Text на телефон Phone. Для некоторых провайдеров необходим уникальный идентификатор сообщения ID (для провайдера iVoice - идентификатор сценария (кампании)). Возвращает ID провайдера для последующей проверки статуса доставки.

CheckSMS(ProviderID) – Проверяет состояние доставки сообщения с идентификатором ProviderID. Возвращает: 0 – доставляется, 1 – успешно доставлено, 2 – не доставлено.

ReceiveSMS(InboxID, DateFrom, DateTo, NewOnly) - Получает входящие SMS, с ящика InboxID (идентификатор выдаётся провайдером). DateFrom, DateTo - задается временной интервал в котором были приняты сообщения(формат 08.04.2013 18:00:00 'DD.MM.YYYY HH:NN:SS'). Чтобы получать только новые сообщение поле NewOnly должно быть True. Возвращает XML с сообщениями.

ExtraResult([ParamName='']) - Вызывается после CheckSMS, возвращает дополнительную информацию по последнему статусу смс. В настоящее время работает только для провайдеров BitCall и iVoice. Для BitCall по умолчанию возвращает кнопки, нажатые абонентом во время работы с голосовым меню. Если в paramname указать 'IdentifyText' то будет возвращен JSON с ответами абонента на заданные вопросы(используется в случае звонков с индивидуальным сценарием). Для iVoice по умолчанию подразумевается параметр 'response', при этом будет возвращен JSON с ответами абонента на заданные вопросы (в зависимости от сценария)

Log - Возвращает последний HTTP запрос и ответ от сервера смс.

== Объект TXML ==

Предназачен для парсинга XML-данных.

Функции:

SetText(S) – Задает текст XML документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию. Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

AttribCount – Возвращает количество атрибутов текущего элемента.

AttribName(i) – Возвращает имя атрибута с номером i.

Attrib(V) – Ищет атрибут и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

Reset – Делает текущим корневой элемент, возвращает его значение.

== Объект TJSON ==

Предназачен для парсинга JSON-данных.

Функции:

SetText(S) – Задает текст JSON документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Можно проверять наличие элементов, если элемента нет, вернется пустая строка.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

Reset – Делает текущим корневой элемент, возвращает его значение.

isArray - Возвращает true, если текущий элемент является массивом (доступ к дочерним элементам возможен только по индексу, нумерация элементов начинается с нуля)

==Объект TZip==
Предназначен для работы с Zip архивом.

SetZip(s) - Загружает архив в объект из строки s;

GetZip - Возвращает архив в виде строки;

AddFromFile(SrcPath, ZipPath) - Добавляет файл SrcPath в архив и располагает его по пути ZipPath. ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

AddFromStr(Data, /*ZipPath*/) - '''параметр ZipPath временно не работает'''. Добавляет файл из строки Data в архив и располагает его по пути ZipPath. -ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

LoadFromFile(path) - Загружает архив из файла path;

SaveToFile(path) - Сохраняет архив в файл path;

Count - Возвращает кол-во файлов в архиве;

DataByIndex(index) - Возвращает распакованный файл в виде строки. Index - номер файла в архиве;

DataByName(ZipPath) - Возвращает распакованный файл в виде строки. ZipPath - путь к файлу в архиве, может содержать каталоги;

FileName(index) - По номеру файла, функция возвращает полный путь файла в архиве.

==Объект TBase==

'''Функции общего назначения''':

'''ExecSimpleScript(Caption, Text)''' - Выполняет скрипт "Дополнительных возможностей". Возвращаемые значения, введенные пользователем устанавливает в переменные $scriptvar1..$scriptvarN, Значения кодов списочных переменных - в переменных $scriptvar1codes..$scriptvarNcodes. Функция возвращает истину, если пользователь нажал "OK" в диалоговом окне.

'''FillAdvPriceReport(Excel, AddressCodes, StartLine, StartCol, [ShowSumPrice,InsertColumns,ShowAll])''' - добавляет отчёт по дополнительным услугам. В AddressCodes - указаны коды адресов через запятую, каждый код это отдельная строка отчета. Адреса будут показаны в порядке перечисления их в AddressCodes. Если в отчет нужно добавить пустую строку, то можно указать код адреса -1000. StartLine, StartCol - верхний левый угол выгружаемой таблицы. ShowSumPrice - добавить столбец итоговый столбец с суммой всех услуг, по умолчанию выключено. InsertColumns - раздвинуть таблицу перед вставкой отчета, позволяет встраивать отчет посередине выгрузки, по умолчанию выключено. ShowAll - показать все дополнительные услуги, по умолчанию false и показывает только услуги с начислениями. Функция возвращает количество использованных столбцов.

'''PrintSticker(Codes, [ToBoxes=False])'''

'''PrintBlanc(Codes, BlancNumber)''' - печатать форму из раздела "Заполнить бланк". Codes - коды корреспонденций, BlancNumber - номер формы из раздела "Бланки для корреспонденции" (3)

'''GetItemByName(Name)'''

'''GetA4Printer([GetPrinterPort=False])''' - возвращает имя принтера выбранного для печати документов. GetPrinterPort - попытаться по имени принтера найти порт принтера.

'''GetStickerPrinter([GetPrinterPort=False])''' - возвращает имя принтера выбранного для печати стикеров. GetPrinterPort - попытаться по имени принтера найти порт принтера.

'''GetDuplexPrinter([GetPrinterPort=False])''' - возвращает имя принтера выбранного для двусторонней печати, если принтер не выбран, возвращает пустую строку.

'''PrintAttachPDFPage(Code, FileName, Page, Printer)''' - печатает страницу из вложенного файла PDF. Code - код вложения (attachment) или путь к файлу, Page - номер страницы, Printer - 0 = принтер A4, 1 = принтер этикеток.

'''AttachPDFToText(Code, [TextFileName])''' - преобразует файл PDF из вложений в текст. Code - код вложения (attachment) или путь к файлу, TextFileName - имя текстового файла, в который записывается результат (если не указан, используется временный файл). Возвращает текст в виде строки.

'''GhostScript(GScript, Code)''' — функция для выполнения консольных команд утилиты [https://ghostscript.readthedocs.io/en/latest/Use.html ghostscript]. Где, GScript — строка с командами Ghostscript; Code — код вложения или путь к PDF-файлу, предназначенному для обработки. В командах доступен специальный тег %MeasoftInFile%, который автоматически заменяется на путь к предварительно загруженному файлу (Code). Если в команде необходимо указать путь для сохранения результата обработки, используйте тег %MeasoftOutFile%. В этом случае функция на основании параметра Code автоматически сформирует имя временного выходного файла. После успешного выполнения команд функция возвращает путь к сгенерированному выходному файлу - %MeasoftOutFile%.

'''GetActiveForm([SkipFormName])''' - возвращает код активной формы в программе где происходит сканирование. SkipFormName - не обязательны параметр, имя формы которую нужно пропустить при определении интерфейса.
'''Список интерфейсов''':
0 - неопределенный;
1 - прием корреспонденции на склад;
2 - АПД;
3 - комплектация адресов (ShelfingForm);
4 - доска приема;
9 - вкладка «Манифесты»;
10 - Инвентаризация корреспонденции;
11 - АПК;
12 - вкладка «Адреса»;
13 - вкладка «Выдача»;
14 - вкладка «Склад»;
15 - Список номенклатуры;
16 - Инвентаризация склада;
17 - Приходная накладная;
18 - Списание товара;
19 - Карточка корреспонденции.

'''AddAddressScanLog(Code[, StrBarCode, IsManual, FromInterface, ExtraInfo])''' - добавляет событие сканирование для корреспонденции с кодом Code. Необязательные параметры: StrBarCode - сканируемый ШК корреспонденции (по умолчанию пустой), IsManual - галка ручного сканирования (по умолчанию false), FromInterface - код интерфейса сканирования (StateType=81, по умолчанию 0 - неопределенный), ExtraInfo - текстовый комментарий события.

'''RuleName(alias)''' - Выдает полный путь в дерева прав по псевдониму права.

'''ShowText(Caption:string, Value:string)''' - показывает пользователю окно с заголовком Caption и с многострочным полем со значением Value. Может быть полезен при отображении логов выполненной операции.

'''ShowScanError(msg [, Speek, Color, Abort])''' - выдает пользователю окно с текстом msg блокируя последующие действия сканирования. Если Speek - истинно, то сообщение проговаривается голосовым движком, по умолчанию выключено. Color - целочисленное число цвета, в который будет окрашен фон сообщения (по умолчанию = -1, стандартный). Abort - прервать выполнение скрипта, не показывая ошибку.

'''CheckRule(alias)''' - функция проверки разрешения у текущего пользователя системы, alias - псевдоним права. Возвращает 1, если право есть и 0, если права нет.
Пример: if(CheckRule('RSE'), ShowMessage('У пользователя есть право изменять счета'), ShowMessage('У пользователя нет права изменять счета'));

'''GetKurierMoney(KurierCode, DateEnd, NonCash)''' - возвращает баланс курьера с кодом KurierCode на дату DateEnd. NonCash - булевый флаг, если истинно, то будет рассчитан безнальный баланс;

'''Функции, работающие только в импорте БД из эксель:'''

ReplaceAddress

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

GetPrice

GetNewNumber - используется при импорте реестра, возвращает номер конверта в загружаемом заказе

GetNewPos - используется при импорте реестра, возвращает порядковый номер вложения

GetNewPackagePos- используется при импорте реестра, возвращает порядковый номер места

Zakaz - возвращает номер заказа куда происходит импорт реестра

addresscode - используется при импорте реестра, код созданного адреса

Source - код заказчика

ClientTown - Узнаем город клиента, через филиал с которым он работает. Сам клиент берется из заказа указанного в окне "Импорт БД из Excel".

== Объект TFieldObject ==
Создается только автоматически. Объект для доступа к записям, используется в картах и дополнительных услугах (addressrecord) и событиях карточки корреспонденции (fieldlist). Методы объекта:

'''_GetTableInfo''' - возвращает данные о полях и примеры данных объекта.

'''_Self''' - возвращает ссылку на объект.

'''_Set(fieldname, fieldvalue [, DoUpdateForm])''' - Если базовый объект строка. Устаналивает для поля fieldname значение fieldvalue. DoUpdateForm по уолчанию false, если указать true то обновление поля будет не только в объекте но и пользовательском интерфейсе. Обновление работает только в карточке корреспнденции для ограниченного набора полей: vlog, mode, type, date_put, time_put, message, kurier, state1.

'''_Set(keyfield, keyvalue, filed, value)''' - Если базовый объект таблица (addressrecord.boxes). Работает перегруженная версия метода _set, cначала происходит поиск строки по ключу, далее меняется значение указанного столбца. keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Пример, отключение услуги база:

addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

== Объект TMessage ==
Создается только автоматически. Объект используется для скриптовой обработки письма в [https://wiki.courierexe.ru/index.php/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F_%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8#.D0.98.D0.BC.D0.BF.D0.BE.D1.80.D1.82_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85| заданиях импорта данных]. В себе содержит текст письма в очищенном формате и оригинальном формате HTML, отправитель письма, тему письма, дата получения и список прикрепленных файлов.

'''Message.Text''' - возвращает очищенный от HTML-тегов текст письма.

'''Message.HTMLText''' - возвращает оригинальный текст письма со всеми HTML-тегами.

'''Message.Sender''' - возвращает email-адрес отправителя письма.

'''Message.AttachmentsCount''' - возвращает количество вложенных файлов.

'''Message.DateTime''' - возвращает дату и время получения письма.

'''Message.Subject''' - возвращает тему письма.

'''Message.GetAttachmentDataString(Number)''' - возвращает вложенный файл под номером Number в виде строки.

'''Message.GetAttachmentName(Number)''' - возвращает имя вложенного файла под номером Number.

== Объект TStringList ==
Может использоваться для построчной обработки многостраничных файлов либо для организации текстовых данных. Номер строк начинается с 0.
Имеет следующий функционал:

'''Count''' - возвращает количество строк в списке.

'''Add(Value:string)''' - добавляет значение Value в конец списка.

'''SetText(Value:string)''' - устанавливает значение списка в значение Value.

'''Insert(Number:integer, Value:string)''' - добавляет строку Value в позицию Number.

'''Delete(Number:integer)''' - удаляет строку из списка в позиции Number.

'''Clear''' - очищает элементы списка.

'''LoadFromFile(Path:string)''' - загружает текстовый файл по пути Path.

'''Strings(Number:integer)''' - возвращает строку с номером Number.

'''SetString(Number:integer, Value:string)''' - устанавливает значение строки с номером Number в значение Value.

'''Text''' - возвращает полный список строк в виде текста.

'''CommaText([Quoted:boolean])''' - возвращает список значений через запятую. Если Quoted = true, то квотирует элементы списка. По умолчанию равен false.

'''SetCommaText(Value: string)''' - разбивает значение Value на отдельные строки и кладет в список. Разделитель - запятые.

'''IndexOf(Value:string)''' - ищет значение Value среди элементов списка и если находит, то возвращает номер строки. Возвращает -1 если значение не было найдено.

'''Sorted(Value:boolean)''' - устанавливает флаг отсортированности списка в Value. Если Value = true, то сразу же его сортирует. По умолчанию Value = false.

'''Exchange(Pos1:integer, Pos2:integer)''' - меняет элементы списка с позициями Pos1 и Pos2 местами.

'''Duplicates(Value:integer)''' - изменяет параметр управления дубликатами в списке. Если Value = 0 (значение по умолчанию), то список не реагирует на дубликаты. Если Value = 1, то список при добавлении будет игнорировать дубликаты. Если Value = 2, то список будет выдавать исключение, при добавлении дубликата в список.

'''ParamName(Number:integer[, Delimiter:string])''' - возвращает текст до первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает пустоту.

'''ParamValue(Number:integer[, Delimiter:string])''' - возвращает текст после первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает всю строку.

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

Основные методы:

'''New'''(FuncName, Param1, Param2, ..., Body) — создание новой функции.Функция возвращает результат выполнения последней команды в теле функции. Аргументы:
* `FuncName` — имя функции (строка)
* `Param1, Param2, ...` — имена параметров функции (переменные начинаются с `$`, объекты — без префикса)
* `Body` — тело функции (скрипт, выполняемый при вызове)

'''FuncName'''(Arg1, Arg2, ...) — вызов созданной функции по имени. Если в объявлении была указана тип переменная, то и подставлять в аргумент надо обязательно переменную. Будет передано значение этой переменной (переменные словарине поддерживаются!). Если был объявлен объект, то указатель на объект должен быть получен через метод '''_self'''. C функциями поддерживают работу следующие классы: TExcel, TDirectExcel, TCSVFile, TADO, TSelfADO, TPrinter, TCanvas, TPicture, TTable, TINIFile, TSMS, TXML, TJSON, TZip, TStringList, TBaseUtils, а также объект addressrecord (TFieldObject). Результатом работы функции может быть число или строка.

Пример 1, обработка результатов функции:
<source>
<?>
new('TFunc', 'calc');
calc.new('Sum', '$a', '$b',
$a + $b
);

set($x, 10);
set($y, 20);
showmessage(calc.Sum($x, $y));
</source>

Пример 2, передача объекта в функцию:
<source>
<?>
new('TFunc', 'utils');
utils.new('ProcessDB', 'dbConn', '$value',
showmessage($value);
dbConn.open('SELECT * FROM address limit 3 ');
if(dbConn.recordcount > 0,
showmessage('Найдено записей: ' + dbConn.recordcount);
dbConn.first;
while(dbConn.eof = 0,
showmessage(dbConn.fieldbyname('code'));
dbConn.next
)
,0)
);

new('TSelfADO', 'db');
utils.ProcessDB(db._self,'test!');
</source>

== Применение языка формул ==
'''в различных контекстах системы «MEASOFT» и сопутствующих проектах'''

=== MEASOFT ===

==== Дополнительная информация на чеке ====

В карточке клиента на закладке «Касса» имеется поле для ввода текста, который будет отображаться на кассовых чеках, печатаемых для корреспонденции от данного клиента. В поле может быть введен как просто текст, так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TSelfDB с открытым набором данных со строчкой корреспонденции, заказа и клиента, на которую печатается чек

TBaseSupport

TBaseValue

Все объекты создаются с пустыми именами.

Так же система записывает в переменную $CashRegisterID вычисленный код фискального регистратора, на котором предполагается печать чека.

Результат работы скрипта печатается на создаваемом чеке, если скрипт не возвращает значение “-1” (число или текст) – в этом случае система чек не создает. Подразумевается, что либо скриптом было принято решение об отсутствии необходимости формирования чека, либо скрипт взял эту функцию на себя.

==== Заполнение шаблонов печатных форм ====

==== Дополнительные возможности ====

==== Импорт БД из Excel ====
В окружении интерпретатора создается объект ZakazRecord, он является списком со значениями таблицы zakaz. Именно в этот заказ будут загружены данные. Из этого объекта также доступно : 
*ZakazRecord.userfields - пользовательские поля заказа;
*ZakazRecord.Clients - данные таблицы clients;
*ZakazRecord.Clients.userfields - пользовательские поля заказчика.

==== Прайс лист клиента ====

Формула возвращает сумму в валюте клиента для каждой поездки (туда или обратно) единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Помимо стандартных объектов, система создает объект AddressRecord, в котором, как свойства, доступны все поля текущей записи. Так же она выставляет значение переменной $Forward в 1 (истина), если необходимо произвести расчет для направления "Туда" и 0 (ложь) - если обратно. ВНИМАНИЕ! Как и во всех остальных местах, после формулы нельзя ставить ";", иначе скрипт вернет 0!

Например:

if(int(AddressRecord.Time_Put_Max)>19, 100, 0)

''Прибавляет 100 рублей в случае, если максимальный срок доставки 20 часов или более''

if(pos(AddressRecord.Address, 'Аренда')>0,
set($FormulaReplace, 1);
1500
, 0)

''В случае наличия подстроки "Аренда" в адресе заменяет штатное ценообразование на 1500 рублей''

Объект AddressRecord может предоставить доступ к связанным таблицам :
* addressrecord.boxes
* addressrecord.packages
* addressrecord.clients
* addressrecord.price
* addressrecord.advprice
* addressrecord.userfields
* addressrecord.addressfld
* addressrecord.clients.userfields
* addressrecord.price.userfields
* addressrecord.zakaz
* addressrecord.zakaz.userfields

Чтобы получить доступ к полю VarCode из таблицы userfields необходимо записать AddressRecord.Userfields.VarCode. В присоединённой таблице может быть несколько записей чтобы получить к ним доступ предусмотрены функции _First, _EOF, _Next, _RecordCount, _Set.

Пример:
set($value1, 0); set($value2, 0);
while(AddressRecord.userfields._EOF=0,
if(AddressRecord.userfields.varCode=1,
set($value1, if(AddressRecord.userFields.VarValue='Праздничная упаковка', 150, 0)), ''''''');
if(AddressRecord.userfields.varCode=2,
set($value2, AddressRecord.userFields.VarValue), ''''''');
AddressRecord.userFields._Next;
);
int($value1) + int($value2)

Пример делающий тоже самое что и выше но через поиск Locate:
set($value1, if(addressrecord.userfields.VarValue('VarCode', 1)='Праздничная упаковка', 150, 0));
set($value2, int(addressrecord.userfields.VarValue('VarCode', 2)));
$value1 + $value2

В скрипте доступны переменные:
«$FormulaKoeff» - это коэффициент на который умножится конечная цена (по умолчанию равна 1);
«$PriceCode» - код прайса;
«$CurrentPriceConf» - код услуги;
«$BasePrice» - стоимость всех услуг с уровнем (pricelevel) меньше текущего.

Для вызова функции CalcBasePrice (Расчёт базовой цены) в скрипте объявленны переменные: $Count,$Collection,$Distance,$Wait.

Существует поиск по ключевому полю (поиск регистронезависимый), например чтобы найти в таблице advprice введённое значение для текущей услуги, нужно сделать такую запись addressrecord.advprice.value('priceconf', $CurrentPriceConf) - Первый параметр это ключевое поле, второй искомое значение. Если запись найдётся будет возвращено значение поле value, если нет функция вернёт значение 0.

Пример
if(addressrecord.advprice.active('priceconf', 3)='T', addressrecord.advprice.price, 0)

''Смотрим включена ли услуга и если да, возвращаем рассчитанную стоимость

Чтобы изменить значение записанное в объект addressrecord, нужно воспользоваться методом _set(keyfield, keyvalue, filed, value). Параметр keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Сначала происходит поиск строки по ключу, далее меняется значение указанного столбца.
Пример, отключение услуги база:
addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

Также существует упрощенный метод _set, с двумя параметрами filed, value - он используется в шаблонах загрузки или в системных доп. возможностях где доступен объект addressrecord.

==== Зарплата курьеров ====

Формула возвращает сумму в основной валюте для каждой единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Переменные «$FormulaTablKoeff» и «$FormulaMoneyKoeff» позволяют установить повышающий или понижающий коэффициент на стоимость доставки (по тарифной сетке) и услуги соответственно (процент от суммы, процент от стоимости доставки, ожидание). Переменная «$UsingZoneName» и «$KurierZone» содержат название и код зоны соответственно, есть возможность поменять название зоны для отчета.

=== Планировщик ===

В поле текста задания может быть введен как текст с командами планировщика (см ниже), так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TIniFile, Указывает на настроечный ini-файл планировщика.

Все объекты создаются с пустыми именами.

Для записи в лог планировщика нужно использовать функцию Print

=== Репликатор ===

== Прочее ==
ReplaceAddress(target, address) – Возвращает адрес последней доставки корреспонденции получателю target по адресу address от текущего клиента. При отсутствии такой доставки, возвращает address.

GetPrice –возвращает рассчитанное значение цены, на основе прайс-листа клиента и данных о корреспонденции.

GetKurierByStation(i) – возвращает код курьера, ассоциированного со станцией метро с кодом i.

GetNewNumber – Возвращает не занятый номер единицы корреспонденции в текущем заказе.

==История изменений==

=== Недавние изменения ===
{|
||'''Изменено:'''
|2026.0.0.550 Доработка функций интерпретатора GetA4Printer, GetStickerPrinter, GetDuplexPrinter.
|-
||'''Изменено:'''
|2026.0.0.547 Доработка функций ATTACHPDFTOTEXT и PRINTATTACHPDFPAGE, добавлена возможность указать путь к файлу
|-
||'''Добавлено:'''
|2025.0.0.539 Добавлена поддержка отладчика AttachDebugger
|-
||'''Добавлено:'''
|2025.0.0.534 Добавлена поддержка оператора CASE и класса TFunc
|-
|}

=== Версия 2021.0.0.57 от 18.06.2019 ===
{|
||'''Добавлено:'''
|В объект TExcel добавлен метод ColumnDelete.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция InsertFirmAtt.
|-
||'''Добавлено:'''
||В объект TExcel добавлен метод Align.
|-
||'''Добавлено:'''
|Функция CheckEan
|-
||'''Добавлено:'''
|В объект функцию FillAdvPriceReport добавлены параметры ShowSumPrice,InsertColumns
|-
||'''Добавлено:'''
|В объект TSMS добавлен метод Log.
|-
||'''Добавлено:'''
|Добавлена функция Money.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция ValutaSign.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция GetPolygonByLatLon.
|-
||'''Добавлено:'''
|В объект TTable добавлена функция SetMultiHeader, SetCustomHeader.
|-
||'''Добавлено:'''
|Функция DownloadAttachment
|-
||'''Добавлено:'''
|В функцию SetRowHeight объекта TExcel добавлен параметр cnt.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция AsString.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция SetSize.
|-
||'''Добавлено:'''
|В объект TADO добавлена функция ParseForIn.
|-
||'''Изменено:'''
|В объект TBaseUtils из TBase перенесена функция FillExcelDoc.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция CalcAddressPrice
|-
||'''Изменено:'''
|Все функции класса TBaseSupport перенесены в TBaseUtils. Класс TBaseSupport больше не существует.
|-
||'''Добавлено:'''
|В функции RowInsert и RowDelete объекта TExcel добавлен параметр count.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция SendToMeaSoft
|-
||'''Добавлено:'''
|В объект TBaseUtils функция RecalcSpecialSMA
|-
||'''Добавлено:'''
|Новая функция Reverse
|}

=== Версия 849   22.02.2018 ===

{|
||'''Добавлено:'''
|В функцию TBaseUtils.TownByIndex добавлен параметр PriorityName
|-
||'''Добавлено:'''
|В объекте TBase добавлена функция GetNewPackagePos
|-
||'''Добавлено:'''
|В объекте TSMS доработан метод ExtraResult, добавлен параметр ParamName
|-
||'''Добавлено:'''
|В объект TBase добавлена функция CalcAgentPrice
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateAddressForActDelivery
|-
||'''Изменено:'''
|Функция CalcTownDeliveryDate заменена на CalcDeliveryDate
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateSpecialSMA
|-
||'''Добавлено:'''
|Функция SignatureUrl
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция LoadFromStr.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetPen.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetBrush.
|-
||'''Добавлено:'''
|В объект TPicture добавлена поддержка чтения в формате PNG.
|-
||'''Добавлено:'''
|В функцию TCanvas.DrawPic параметр Mode
|-
||'''Добавлено:'''
|Свойство TPicture.Canvas
|-
||'''Добавлено:'''
|Функция DeleteFile
|}

=== Версия 758   29.03.2017 ===
{|
||'''Добавлено:'''
|Функция GetPolygonByAddress
|-
||'''Добавлено:'''
|Функция ParamsCount
|-
||'''Добавлено:'''
|Объект TZip
|-
||'''Изменено:'''
|Функции CreateEAN и Create128 заменены одной функцией CreateBar, полностью совместимой с Create128, но добавлена поддержка EAN-13 и Interleaved 2-5 (для Почты России). В системе функции оставлены для обратной совместимости, но более не являются документированными и рекомендованными к использованию.
|-
||'''Добавлено:'''
|Параметр text в функцию Cell объекта TExcel
|-
||'''Добавлено:'''
|Функция UrlEncode
|-
||'''Добавлено:'''
|Функция IncDay теперь может принимать параметр count
|-
||'''Добавлено:'''
|Функции FtpGet, FtpPut, TTable.SetCell()
|}

=== Версия 452   26.02.2014 ===

{|
||'''Добавлено:'''
|Функция Time
|-
||'''Добавлено:'''
|Функция FixedIntToStr
|-
||'''Добавлено:'''
|Функция TimePeriod
|-
|'''Добавлено:'''
|В интерпретатор добавлена функция приёма смс - ReceiveSMS
|-
|'''Добавлено:'''
|Функция STR2UTF
|-
|'''Добавлено:'''
|Функция SAVETOFILE
|-
|'''Добавлено:'''
|Функция TExcel.SetSheetName
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "FILESTR"
|-
|'''Добавлено:'''
|Расширены возможности объекта addressrecord в формулах тарифов
|}

=== Версия 308   24.11.2012 ===

{|
|'''Добавлено:'''
|В функции загрузки таблиц из TADO добавлено условие, что поля, названия которых начинаются с "-" не выгружаются. Таким образом можно скрывать служебные поля из результирующего набора.
|-
|'''Добавлено:'''
|Функция TExcel.RowAutoFit
|-
|'''Добавлено:'''
|Функция TExcel.RowInsert
|}

=== Версия 300   01.11.2012 ===

{|
|'''Добавлено:'''
|В объекте TCSVFile добавилась возможность запрашивать значения не только текущей записи через параметр сдвига
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "UPDOWN"
|-
|'''Добавлено:'''
|В интерпретатор добавлен объект TCSVFile
|}

=== Версия 266   14.09.2012 ===

{|
|'''Добавлено:'''
|В интерпретатор добавлена поддержка массивов
|}

=== Версия 265   11.09.2012 ===

{|
|'''Добавлено:'''
|Функция CreateTrans в интерпретатор
|-

Руководство программиста

2026-01-16T13:25:39Z

Sammy: /* Объект TBase */

== Основные положения ==

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

Как интерпретатор приводит типы:

1. При использовании значения как параметр функции интерпретатор автоматически приводит значение к типу, необходимому функции.

2. При операциях сложения, а также логических операциях, операнды приводятся к строке если хотя бы один из них имеет тип «строка». Например:
3.3+5 -> 8.3
‘3.3’+5 -> ‘3.35’
подобную проблему можно решить принудительно преобразовав тип:
float(‘3.3’)+5 -> 8.3

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

Как работают функции приведения типов:

1. При преобразовании строки к числу: функция «читает» строку до первого символа, не позволяющего создать число с плавающей точкой, при этом разделителем целой и дробной частей может быть как точка так и запятая. Если приведение производится к целочисленному типу, то после этого происходит округление. Например:
float('3.6qwerty735') -> 3.6
int('3.6qwerty735') -> 4

2. При преобразовании к булевому типу ложью считается пустая строка либо число 0, все остальное - истина

3. При преобразовании булевого типа к числу истина преобразуется в 1, ложь – в 0. Такое преобразование позволяет использовать сложение и умножение в качестве логических «ИЛИ» и «И» соответственно:
if((5=5)+(6=7), <a>, [b]) – условие истинно, выполнится код «a».

4. При преобразовании булевого типа к строке сначала происходит преобразование к числу:
(5=5)+'qwerty' -> ‘1qwerty’

== Описание синтаксиса ==

Команды разделяются точкой с запятой. Параметры функций разделяются запятыми. Каждая команда (даже цикл while) является функцией, возвращающей некоторое значение. Результатом выполнения составной команды (последовательности функций, разделенных точкой с запятой), является результат выполнения последней функции. Имена переменных, функций, объектов, а также их свойств и методов не чувствительны к регистру.
Константы: константы бывают целочисленными, дробными и строковыми. Значения целочисленных и дробных констант указываются «как есть» (в этом случае разделитель целой и дробной частей – точка), шестнадцатеричные значения начинаются с символа «$» и, если первая цифра – буква, она упреждается цифрой 0, а строковые – в одинарных кавычках. При этом, если внутри строковой константы встречается символ одинарной кавычки он должен быть задвоен, для указания интерпретатору того, что он не является признаком конца константы.
Операции сравнения: >, <, =, ! - Больше, меньше, равно, не равно соответственно.
Логические операции: + (ИЛИ), * (И).
Арифметические операции: +, -, *, /
Операция конкатенации строк: +

=== Функциональность базового объекта ===

'''SET($a, a)''' – присваивает переменной (1-й параметр) значение второго параметра. При отсутствии переменной – создает ее. Имена переменных должны начинаться с символа «$», а следующий символ не должен быть цифрой. Возвращает новое значение переменной. Функция используется только для задания значений переменных. Не допускается использования для задания значений свойств объектов. Для этого используются соответствующие методы этих объектов.

'''IF(a,b,c)''' или '''IF(a,b)''' – Условный оператор. В первом случае возвращает b, если a истинно (не равно нулю или пустой строке), иначе – c. Во втором случае – возвращает a, если оно истинно, иначе – b.

'''WHILE(a, b)''' – Оператор цикла. Выполняет b пока a истинно:
set($i, 10);
set($sum, 0);
while($i>0, set($sum, $sum+$i); set($i, $i-1));
$sum
Результат – 55

'''FOR($a, b, c, d)''' – Оператор цикла. Выполняет d пока $a последовательно присваиваются значения от b до с включительно:
set($sum, 0);
for($i, 1, 10, set($sum, $sum+$i));
$sum
Результат – 55

'''NEW(ClassName, InstanceName)''' – Создает экземпляр класса ClassName, назначает ему имя InstanceName. Возвращает порядковый номер созданного объекта. Доступ к свойствам и методам объектов осуществляется по имени объекта и имени свойства/метода, разделенным точкой. Именем объекта может быть и пустая строка, тогда доступ к его свойствам и методам будет осуществляться без указания имени, и, в случае совпадения имен свойств и/или методов со стандартными или свойствами/методами других объектов, использоваться будут соответствующие свойства/методы объекта, созданного ранее, а также такой объект невозможно уничтожить до окончания выполнения скрипта. Все объекты созданные во время выполнения скрипта уничтожаются автоматически после окончания его выполнения.

'''FREE(InstanceName)''' – Уничтожает объект с именем InstanceName. Возвращает 0. В случае отсутствия объекта с заданным именем вызывает ошибку.

'''ShowObjects''' – Возвращает список созданных объектов – названия классов и имена.

'''ERROR(message)''' – Вызывает ошибку с текстом message.

'''SHOWMESSAGE(message)''' – Отображает диалоговое окно с текстом message, останавливает выполнение скрипта до закрытия окна пользователем.

'''SimpleAskUser(Message)''' – Выводит диалоговое окно с текстом Message и кнопками «Да» и «Нет». Возвращает 1, если пользователь нажал кнопку «Да», иначе – 0.

'''TRY(a)''' – Выполняет a в «защищенном от ошибки» режиме. Если в процессе выполнения a возникает ошибка, возвращает текст ошибки, иначе – 0 (ложь).

'''REM(….)''' – Код в скобках игнорируется (комментарий).

'''EXEC(FileName, Params, Wait, WindowState)''' – Запускает внешнее приложение FileName с параметрами Params. Если Wait истинно – ожидает завершение процесса. Для WindowState доступны следующие числовые значения:
0 - SW_HIDE
1 - SW_SHOWNORMAL (по-умолчанию)
3 - SW_MAXIMIZE
6 - SW_MINIMIZE
Функция возвращает истину если приложение запущено успешно. Иначе – Ложь.
В случае успеха, при параметре Wait – истина кладет в переменную $LastResult код завершения приложения.

'''CASE''' - Оператор множественного выбора. Позволяет выполнить одно из нескольких действий в зависимости от условий. Синтаксис:
<source>
case(
when(условие1, действие1);
when(условие2, действие2);
...
else(действие_по_умолчанию);
);
</source>

Пример использования:
<source>

set($a, 10);
set($b, 50);

showmessage(
case(
when($a < 5, 50);
when($a < 10, 100);
when($a < 250, 200);
else($a*$b);
)
);
</source>

'''AttachDebugger''' - Команда позволяет подключить открытый [[Отладчик_встроенных_скриптов]] к текущему скрипту. Команда AttachDebugger должна быть '''первой командой''' в скрипте. Добавьте её в самое начало скрипта:

<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Как работает:'''
# При выполнении команды AttachDebugger скрипт останавливается.
# Отладчик автоматически подключается к выполняющемуся скрипту.
# Текст скрипта загружается в редактор отладчика.
# Можно ставить точки останова, просматривать переменные и продолжать отладку.

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Если режим отслеживания не включён, команда `AttachDebugger` игнорируется.
* В режиме отслеживания может работать только один отладчик.
* Команда AttachDebugger должна быть первой командой в скрипте.

=== Строковые функции ===

'''UpCase(s)''' – возвращает строку s в верхнем регистре.

'''LCase(s)''' – возвращает строку s в нижнем регистре.

'''Len(s)''' – возвращает количество символов в строке s.

'''Pos(s, substr [,start])''' – возвращает номер первого символа первого включения подстроки substr в строку s, возвращает 0, если включения подстроки отсутствуют. Параметр start - это позиция старта поиска, не обязательный параметр, по умолчанию равен 1. Поиск не чувствителен к регистру.

'''Param(s, i)''' – возвращает i-й элемент строки s, разделенной запятыми на элементы.

'''ParamsCount(s)''' - возвращает количество элементов строки s, разделенной запятыми на элементы.

'''SetParam(s, p, i)''' – заменяет на значение p i-й элемент строки s, разделенной запятыми на элементы.

'''Left(s, i [,full] )''' – возвращает i первых символов строки s. Параметр i, может быть строкой, тогда он считается разделителем и функция, возвращает строку слева от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Mid(s, i, j)''' - возвращает подстроку из s начиная с i символа и длиной j символов

'''Right(s, i [,full])''' – возвращает i последних символов строки s. Параметр i, может быть строкой, тогда он считается разделителем, функция ищет разделитель с конца строки, и возвращает строку справа от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Reverse(s)''' - возвращает строку s задом-наперед. Полезно например для поиска с конца функций Pos().

'''Char(i)''' – возвращает символ с кодом i.

'''Ord(s)''' – возвращает код первого символа строки s.

'''Replace(s, strFind1, strReplace1, [ strFind2, strReplace2, ... ], [caseInsensetive])''' - возвращает строку s, в которой все включения строк strFind заменены строкой strReplace. Параметры поиска и замены всегда должны быть в паре и их может быть несколько. caseInsensetive - неучитывать регистр, не обязательный параметр, по умолчанию включен.

'''RemSpace(s)''' – возвращает сроку s без начальных и конечных запятых и пробелов, а также начальных точек.

'''SumStr(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''с добавлением валюты'''. Необязательные параметры captions - позволяет изменить название валюты, формат строки может зависеть от текущего языка(посмотреть формат можно в "Справочники"-"Статусы"-"32 Валюты", в разделе "Дополнительная информация"). Language - код языка на котором необходимо вывести сумму прописью. По умолчанию если не обязательные параметры опущены, используются региональные настройки в переменных.

'''NumToStrSimple(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''без валюты'''. Параметры идентичны функции SUMSTR.

'''FullNameToShort(Name)''' – Возвращает фамилию и инициалы по полному ФИО Name.

'''MonthName1(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в именительном падеже.

'''MonthName2(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в родительном падеже.

'''StrForXML(s)''' - Подготавливает строку к парсингу как xml: Если находит в строке подстроку "UTF-8" - перекодирует ее из utf-8 в win-1251, убирает начальный знак вопроса, если такой встречается.

'''FixedIntToStr(i, len[, char])''' - Возвращает целое число i дополненное слева символами char (по-умолчанию - "0") до длины len.

'''Translate(format, [param1, param2, ...])''' - Функция перевода строки format в язык пользователя. Строка format может содержать параметры %s, %d - строка и число соответственно.

'''ExtractFileName(FilePath)''' - возвращает имя файла с расширением из полного пути к файлу FilePath.

====Функции перекодировки====
'''DecodeStr(s, charset)''' - Производит перекодировку строки s в кодировку CP1251. Кодировка строки s должна быть заранее известна и может быть :
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866, UNICODE. Имя кодировки следует передавать в точности без лишних символов.

'''EncodeStr(s, charset)''' - Производит перекодировку строки s в кодировку charset. Кодировка строки s должна быть CP1251, возможны следующие варианты перекодировки:
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Имя кодировки следует передавать в точности без лишних символов. UNICODE не работает с версии 2021, в ней строки по умолчанию в кодировке unicode.

Функции EncodeBase64(s), DecodeBase64(s), UrlEncode(s), UTF8Encode(s), UTF8Decode(s), Str2UTF(s) - устарели, используйте EncodeStr, DecodeStr.

====Транслитерация====

'''Translit(s)''' - транслитерация строки русского текста s латиницей

'''UnTranslit(s)''' - транслитерация строки s с латиницы на русский.

==== Экранирование ====

'''QUOTEDSTR(s)''' – квотирует строку s символом «\» (обратный слеш). Возвращает строку s, помещенную между символами одинарной кавычки, при этом все вхождения в строку s символов: «\», «"» и «'» экранируются квотирующим символом, а символы #0, #10 и #13 заменяются на \0, \n и \r соответственно.

'''SQLFloat(f)''' – Приводит число с плавающей точкой к виду, пригодному для SQL-запроса, т.е. к тексту с разделителем дробной части – точка.

'''FormatTextXML(s)''' - квотирует строку s для использования в XML. Производит замены спец. символов для корректности XML-синтаксиса.

'''FormatTextJSON(s)''' - переводит строку в формат JSON, экранирует служебные символы.

'''FormatTextBlob(s)''' - строка s содержит файл, функция перекодирует переданную строку в байты, используется для заполнения полей формата blob.

====Хеширование ====

'''HMACHash256(key, text)''' - создаёт хэш по алгоритму SHA256 для проверки целостности сообщения, key - секретный ключ, text - хэшируемое сообщение

'''MD5Hash(text)''' - создаёт хеш по алгоритму MD5

'''SignatureUrl(url)''' - Подписывает переданный URL. Функция возвратит переданный URL с добавленным в конце параметром, в котором будет записана подпись.

=== Функции работы с датой и временем ===

'''CurrTime''' – возвращает текущее время

'''CurrDate''' – возвращает текущую дату

'''CurrMillisecond''' - Возвращает количество миллисекунд прошедших с начала текущего года. Используется для точного расчета временных интервалов.

'''Today''' - возвращает текущую дату в числовом формате.

'''Day(dt)''' – возвращает день месяца даты dt.

'''Month(dt)''' – возвращает месяц года даты dt.

'''Year(dt)''' – возвращает год даты dt.

'''FirstDayOfMonth(dt)''' – Возвращает первый день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( FirstDayOfMonth( CurrDate() ) );
'''Полужирное начертание'''
'''LastDayOfMonth(dt)''' – Возвращает последний день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( LastDayOfMonth( CurrDate() ) );

'''DaysInMonth(month, year)''' – Возвращает количество дней в указанном месяце.

'''IncDay(dt, [count=1])''' – Возвращает дату, увеличенную на count дней.

'''SQLDate(dt)''' – Пытается конвертировать dt в дату, вернуть в формате «'YYYY-MM-DD'» (с апострофами), если не удается – возвращает «NULL».

'''SQLDateToDate(dt)''' – Переводит дату из SQL-формата в обычный.

'''DAYSBETWEEN(dt1, dt2)''' – Возвращает количество дней между датами dt1 и dt2. В случае ошибки приведения dt1 или dt2 к дате возвращает -1000.

'''TimeBetween(t1, t2)''' - Возвращает количество минут между временем t1 и t2. Если t1 > t2 то будет показано количество минут между t2 и t1. Параметр t может быть как в формате "HH:MM", так и в числовом. Если один из параметров не удалось привести к числовому типу возвращает -1000.

'''WorkDaysBetween(dt1, dt2, [DecreaseFirstDay=0], [DefaultHolidayVarNum=1])''' - Возвращает количество рабочих дней между датами dt1 и dt2. Параметр DecreaseFirstDay уменьшает dt1 на указанное количество дней (по умолчанию 0). В случае ошибки приведения dt1 или dt2 к дате возвращает -1000. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней(по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''TimePeriod(time1, time2)''' - Оформляет временной период. Возвращаемое значение зависит от наличия значения в параметрах. Возможные варианты: "time1 - time2" , "С time1" , "ДО time2".

'''StrDateToFloat(s, [time=false])''' - Переводит строку с датой s в числовой тип. Если параметр time включен, то в строке s должно быть указано время. Дата должна быть в формате "DD.MM.YYYY", а время "HH:NN". Если строку перевести не удалось возвращает 0

'''IsAWorkDay(dt)''' - Когда день dt является рабочим, возвращает true. Если произошла ошибка приведения даты возвращает -1000.

'''IncWorkDay(dt, [count=1],[DefaultHolidayVarNum=1])''' - Прибавляет count рабочих дней к дате dt. Возвращает дату в числовом формате, если произошла ошибка приведения даты возвращает -1000. По умолчанию параметр count равен 1 и не является обязательным. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней (по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''Sleep'''(n) - Задержка выполнения на n миллисекунд.

=== Функции приведения типов ===

'''INT(v)''' – возвращает значение типа “целое”, приводя вариантное значение v к числовому типу, а затем округляя его. В том числе используется как функция округления.

'''FLOAT(v)''' – возвращает значение типа “число”, приводя вариантное значение v к числовому типу, переводя в число цепочку символов до первого нецифрового символа (либо точки или запятой).

'''STR(v)''' – возвращает значение типа “строка”, приводя вариантное значение v к строковому типу.

'''Date(v)''' – возвращает дату, либо пустую строку, если не удается конвертировать v в дату

'''Time(v)''' – возвращает время, либо пустую строку, если не удается конвертировать v во время. Понимает числовое представление времени.

=== Математические функции ===

'''ROUNDUP(f)''' – округляет число f до ближайшего большего по модулю целого числа.

'''ROUNDDN(f)''' – округляет число f до ближайшего меньшего по модулю целого числа.

'''Money(f, CouldBeEmpty, ZeroFill, MakeSpace)''' - Округляет число f, до двух знаков после запятой. CouldBeEmpty - заменить число меньше 0,0001 на пустую строку. ZeroFill - Следить чтобы после запятой было два знака, если будет один, то добавить ноль. MakeSpace - Разделить разряды пробелом.
''Подсказка: для простого округления используется функция int()''

'''Abs(f)''' - возвращает модуль числа f.

'''Mod(x, y)''' - возвращает остаток от деления целочисленного числа x на целочисленное число y.

=== Константы ===

'''Null''' – Возвращает пустое значение.

'''Да''', '''True''', '''Нет''', '''False''' – константы, соответствующие булевым значениям.

=== Прочие функции ===

SetPhoneParams(CountryCode, TownCode) – Устанавливает глобальные настройки кода телефонных кодов страны и города соответственно. По-умолчанию код страны – 7, код города – 495.

PhonesCount(s) – Возвращает количество корректных телефонных номеров, найденных в строке s.

GetPhone(s[, n]) – Возвращает n-й корректный телефонный номер, найденный в строке s. Нумерация начинается с 1.

GetEmail(s) – Возвращает все корректные адреса email, найденный в строке s, разделенные запятыми (т.е. готовыми к передаче в функцию SendEmail).

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

GenEan(ID, Code) – Формирует штрих-код EAN 13 Состоящий из идентификатора типа сущности ID и кода сущности Code, Выравнивает до 13-ти символов, первый – «2», последний – контрольная сума.

CheckEan(s) - Проверяет строку s, что она является кодом EAN13.

SaveToFile(FileName,s, encoding [, append])- Создает текстовый файл по пути, указанному в FileName (если по указанному пути существует файл с указанным именем, он удаляется и создается новый) и производит запись строки s в созданный текстовый файл. encoding - название кодировки, по умолчанию сохраняет в кодировке ANSI. Доступные названия кодировок: KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Если append = true, то производится дописывание данных в файл, а не перезаписывание (не обязательный, по умолчанию выключен).

StrFromFile(FileName) - Читает файл FileName, возвращает в виде строки. При ошибке чтения вызывает ошибку.

DownloadAttachment(code, [savefilepath, tablename='attachment', fieldBlob='file', fieldLDtime='ldtime', fieldUID='uid']) - Функция выкачивает аттачмент из базы, по внутреннему коду - Code, всегда возвращает содержимое файла в виде строки, а также может сохранить файл по указанному пути в параметре savefilepath. По умолчанию, функция настроена на таблицу attachment. Code - внутренний код вложения, tablename - название таблицы, fieldBlob - название поля с содержимым файла, fieldLDtime - название поля с временем последнего изменения строки (для работы кэша). Функция использует кэш и умеет выкачивать файлы зауженные на внешние серверы (http, ftp,sftp, measoft). Для выкачивания с сервера measoft обязательно необходимо указывать параметр fieldUID.

DeleteFile(FileName) - Удаляет файл FileName с диска, возвращает истину, если операция прошла успешно и ложь - в противном случае.

HTTPPOST(host, PostParams, Proxy, ContentType, HTTPUser, HTTPPass, Method, CustomHeader, Reconnects) - Отправляет HTTP запрос по адресу host с данными PostParams. Proxy - объект Proxy, задающий прокси-сервер (по-умолчанию - пусто - не использовать прокси). ContentType - Заголовок ContentType. По-умолчанию - "application/x-www-form-urlencoded; Charset=UTF-8". HTTPUser и HTTPPass - данные для http-авторизации на сервере. Method - метод отправки запроса, по-умолчанию - "POST". CustomHeader - Дополнительные заголовки HTTP запроса, передается в виде списка параметров через запятую и всегда образуют пару: 1 параметр - название заголовка, 2 параметр - значение. Если значение содержит запятую то его нужно экранировать в двойные кавычки. Reconnects - Количество попыток подключения (по-умолчанию - 2), если больше 100 - это таймаут единственной попытки подключения в миллисекундах.
Функция возвращает ответ сервера. 
''Обратите внимание:'' Для имитации отправки данных html-формы методом POST может понадобиться перед передаваемыми параметрами добавить "Data=".

FTPPUT(host, User, Pass, FileName[, Active]) - Отправляет файл на FTP/SFTP-сервер. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

FTPGET(host, User, Pass, SourceFileName, DestFileName[, Active]) - Загружает файл SourceFileName с FTP/SFTP-сервера, сохраняет его в файл DestFileName. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

GetTempDir - Возвращает путь к временной папке.

ApplicationDir - Возвращает путь к файлу программы.

Interpretate(script) - Интерпретирует скрипт указанный в script. Выполнение происходит в текущем инстансе.

LastHttpError - Выводит последний запрос выполненный с ошибкой в функции HttpPost. Содержит подробную информацию по запросу и ответу.

LastHttpResponse - Выводит последний запрос и ответ от сервера после выполнения Http-запроса в функции HttpPost.

== Объект TExcel ==

Предназначен для доступа к данным документов MS Excel. Требует установленного приложения MS Excel. Для работы без установленного MS Excel предусмотрен объект TDirectExcel.

'''''Ввод данных'''''

LoadFromDB(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Если Headered истинно (по-умолчанию), таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Если TranslateHeader истинно, то заголовки таблицы будут автоматически переведены.

MyDB.Open('select * from kurier');
xl.LoadFromDB(MyDB.Self);
xl.DoNotDestroy(true);
xl.SetVisible(true);

Post2Sheet(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) - Почти полный аналог LoadFromDB. В отличии от LoadFromDB если есть открытый файл, выгрузка данных будет выполнена прямо в него.

OpenFile(aFileName) – Выполняет функции SetFileName и Open.

FileName – Возвращает имя текущего файла.

SetFileName(aFileName) – Задает значение свойства FileName.

Open - Открывает файл с именем, заданным свойством FileName. Если имя файла не задано - создает чистую книгу.

Close – Закрывает текущий файл.

'''''Ячейки'''''

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

Cell(x, y, text) – Возвращает значение ячейки, заданной координатами x, y. Необязательный булевый параметр text, в случае истинности, указывает на необходимость возврата данных с учетом формата ячейки, т.е. то, что пользователь видит на экране. Обратите внимание, что если в ячейке число, и ширина столбца не достаточна для отображения, Excel выводит "#####", что и будет возвращено программе, если text=ИСТИНА. Поэтому перед таким использованием рекомендуется выполнить функцию AutoFit.

SetCell(x, y, v[, x2, y2]) – Устанавливает значение ячейки, заданной координатами x и y, в значение v. Если заданы параметры x2, y2 - объединяет (merge) диапазон ячеек заданных координатами, устанавливает значение объединенной ячейки.

'''''Строки'''''

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

RowAutoFit([y1, y2]) - Устанавливает автоматическую высоту строк. Аргументы y1 и y2 необязательны и если не указаны, то процедура будет выполнена для всей страницы, в ином случае только для строк от y1 до y2.

SetRowHeight(r, h[, cnt]) – Устанавливает высоту cnt строк (по-умолчанию 1) начиная со строки r в h пикселей.

GetRowHeight(r) – Возвращает высоту строки r в пикселях.

RowInsert(i[, count]) - Вставляет count (по-умолчанию - 1) строк НАД строкой с номером i.

RowDelete(i[, count]) - Удаляет count (по-умолчанию - 1) строк начиная с номера i.

'''''Столбцы'''''

ColCount - Возвращает количество столбцов в листе.

AutoFit – Устанавливает автоматическую ширину столбцов.

ColumnDelete(i[, count]) - Удаляет count (по-умолчанию - 1) столбцов начиная с номера i.

SetColWidth (c, w) – Устанавливает ширину столбца c в w пикселей.

GetColWidth (c) – Возвращает ширину столбца c в пикселях.

'''''Листы'''''

SetSheet(No) – Устанавливает номер текущего листа. Если лист с таким номером не существует - он будет создан (и все листы до него). Нумерация начинается с 1.

SetSheetName(Name) - Устанавливает название текущего листа.

SheetsCount – Возвращает количество листов в книге.

CopySheetAfter([SheetFrom[, SheetAfter]]) - Копирует лист SheetFrom (по-умолчанию - текущий), создавая новый лист после листа SheetAfter (по-умолчанию - совпадает с копируемым).

SheetDelete(i) - Удаляет лист с номером i.

'''''Форматирование'''''

Align(x1, y1, x2, y2 [,HAlign, VAlign]) - Устанавливает выравнивание данных в указанном диапазоне. HAlign - горизонтальное выравнивание (0 – прижато влево , 1 – по центру , 2 – прижато вправо), VAlign - Вертикальное выравнивание (0 – прижато к верху , 1 – по центру , 2 – прижато к низу).

WrapText(x1, y1, x2, y2, value) – Устанавливает перенос текста прямоугольника в значение value. Если координаты опущены, или 0 – устанавливает границы всей используемой области. Для Value значение по-умолчанию - true.

NumberFormat(x1, y1, x2, y2, Format) - Устанавливает формат вывода чисел в указанном диапазоне ячеек. Например, если Format='0.00' - числа будут выводиться c обязательными 2 знаками после десятичного разделителя.

SetBorders(x1, y1, x2, y2) – Устанавливает границы прямоугольника. Если координаты опущены, или 0 – устанавливает границы всей используемой области.

SetFont(Font[, x1, y1[, x2, y2]]) - Устанавливает шрифт Font для ячеек диапазона. Можно указать координаты только одной ячейки, можно - вообще не указать, тогда будет использован последний выделенный диапазон. Шрифт задается как обычно: 'Arial, 16, T, T, T', порядок параметров: Имя шрифта, размер, жирное начертание, курсивное начертание, одиночное подчеркивание. Если параметры не заданы, то у текущего шрифта они меняться не будут. Примеры: SetFont('Arial, 10, T, F, F', 1,1) - в ячейке A1 будет установлен шрифт Arial жирным начертанием (не курсив и без подчеркивания). SetFont(', , , T, F', 2,1) - в ячейке B1 будет поменяется только начертание курсив и будет отменено подчеркивание (если оно было).

SaveValuesOnly - убирает формулы на текущей странице и оставляет лишь их результативные статичные значения.

'''''Цвета'''''

SetRowFontColor(Row,Color) - Устанавливает цвет шрифта в строке Row. Color - целое значение (RGB)

SetRowColor(Row,Color) - Устанавливает цвет фона в строке Row. Color - целое значение (RGB)

SetColumnFontColor(Col,Color) - Устанавливает цвет шрифта в столбце Col. Color - целое значение (RGB)

SetColumnColor(Col,Color) - Устанавливает цвет фона в столбце Col. Color - целое значение (RGB)

SetCellFontColor(Row,Col,Color) - Устанавливает цвет шрифта в ячейке с координатами [Row,Col]. Color - целое значение, равное номеру цвета в палитре (ColorIndex,не RGB)

SetCellColor(Row,Col,Color) - Устанавливает цвет фона в ячейке с координатами [Row,Col]. Color - целое значение (RGB)

GetRowFontColor(Row)- Возвращает RGB значение цвета шрифта строки Row

GetRowColor(Row)- Возвращает RGB значение цвета фона строки Row

GetColumnFontColor(Col)- Возвращает RGB значение цвета шрифта столбца Col

GetColumnColor(Col)- Возвращает RGB значение цвета фона столбца Col

GetCellFontColor(Row,Col) - Возвращает номер цвета шрифта в палитре (ColorIndex) в ячейке с координатами [Row,Col]

GetCellColor(Row,Col) - Возвращает RGB значение цвета фона в ячейке с координатами [Row,Col]

'''''Копи-паст'''''

Copy(x1, y1, x2, y2) - Копирует в буфер экселя

Cut(x1, y1, x2, y2) - Вырезает в буфер экселя

Paste(x1, y1) - Вставляет из буфера экселя. Команды copy-paste неразрывны, если что нибудь сделать в промежутке между ними, например вставить значение в ячейку, то копирование сброситься. (Последовательность использования: copy - paste, cut - paste)

PasteStyle(x1, x2, y1, y2) - Вставляет только оформление из буфера экселя (Последовательность использования: Copy - PasteStyle)

'''''Изображения'''''

InsertPicture(TPicture, [x=1, y=1, DispX=0, DispY=0, width=0, height=0]) - Функция вставляет рисунок на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки, width, height (не работает для DirectExcel) - ширина и высота области рисунка в пойнтах-единицах Excel

InsertFirmLogo(FirmCode, [x=1, y=1, DispX=0, DispY=0]) - Функция вставляет логотип фирмы с кодом FirmCode на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки.

'''''Вывод'''''

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки. Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SheetFitPageWidth - устанавливает режим масштабирования печати, чтобы печатная форма помещалась в ширину на один лист.

SetOrientation(value) - Устанавливает ориентацию страницы. True (по-умолчанию) - альбомная (ландшафтная), Ложь - портретная.

PrintOut([copies]) - Печатает текущий лист на принтере по умолчанию. Параметр copies - количество копий, по умолчанию равен 1.

Save(filename) - Сохраняет в файл filename. Если файл существует, в основной системе он будет перезаписан, в других проектах - вызовет ошибку "Файл уже существует".

SetVisible(b) – Устанавливает видимость приложения Excel для пользователя. По-умолчанию – false (не видимо).

DoNotDestroy(b) – При уничтожении объекта TExcel (а он уничтожается, как и все остальные объекты автоматически при завершении выполнения скрипта), приложение Excel уничтожается вместе с ним. DoNotDestroy(true) отключает уничтожение приложения.

'''''Пример использования'''''

new('TExcel', 'myxl');
myxl.OpenFile('c:\asdf.xlsx');
set($sum, 0);
while (myxl.EOF=0,
set($sum, $sum+int(myxl.c));
myxl.next );
$sum

''Возвращает сумму всех числовых данных столбца C файла 'c:\asdf.xlsx'''

== Объект TDirectExcel ==
Объект позволяет работать с файлами Excel напрямую, без установленного пакета MsOffice. Применяется в сервисах и при отсутствии экселя. Он максимально совместим с объектом TExcel, однако некоторые методы могут быть не реализованы.

== Объект TCSVFile ==
Предназначен для доступа к данным документов CSV. Разделителем столбцов является символ точка с запятой ;

Функции:

FileName – Возвращает имя текущего файла.

OpenFile(FileName) – Открывает файл FileName.

LoadFromDB(DB[, Headered=false]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO.

LoadFromText(s) - Загружает таблицу из строки s.

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки.

SaveToFile(Filename) - Сохраняет в файл с именем filename.

== Объект TADO ==

Предназначен для доступа к базам данных.

Функции:
{| class="wikitable"
!Функция
!Описание
|-
|Connect(ConnectionString)
|Подключает к источнику данных. ConnectionString – Строка подключения ADO.
|-
|ConnectMySQL(DBServer, DBPort, DBUser, DBPass, DBName)
|Подключает к базе данных MySQL.
|-
|Open(Query)
|Открывает набор данных выполнив запрос Query.
|-
|FieldByNo(i)
|Возвращает значение поля с номером i. Нумерация полей – с нуля.
|-
|FieldName(i)
|Возвращает имя поля с номером i.
|-
|FieldCount
|Возвращает количество полей.
|-
|RecordCount
|Возвращает количество записей.
|-
|RecNo
|Возвращает номер текущей записи. ''ВНИМАНИЕ! В зависимости от способа подключения к БД нумерация может начинаться как с 0 так и с 1!''
|-
|EOF
|Возвращает признак достижения конца набора данных. Становится истиной когда выполняется команда Next на последней записи.
|-
|Next
|Переход на следующую запись набора.
|-
|First
|Переход на первую запись набора.
|-
|Last
|Переход на последнюю запись набора.
|-
|FieldByName(FieldName)
|Возвращает значение поля по имени. Также возможно указание имени поля как свойства объекта.
|-
|Field(Table, ID, FieldName)
|Возвращает значение поля FieldName записи с кодом ID таблицы Table. Набор данных, если он открыт, при этом не закрывается. Первичный ключ таблицы должен называться «code». Гарантированно работает только с MYSQL!!!
|-
|GetSQLValue(Query)
|Выполняет SQL-запрос. Текст запроса должен начинаться с первого символа строки (перед запросом не должно быть пробелов, переносов строк, комментариев и т.д.). Если запрос Insert – возвращает ID вставленной записи. Если запрос – Update, Delete, Replace, Set, Start, Commit, Rollback – возвращает количество измененных записей (RowsAffected), иначе – Select – значение первого поля первой строки результата как текст.
|-
|FillText(s)
|Возвращает строку s с замененными названиями полей между знаками процента на соответствующие значения текущей записи. Так же в строке возможно использование интерпретируемого кода, заключенного между тегами "<?>" и ">". При интерпретации система сначала производит замену полей с процентами на значения, потом интерпретирует код. ''Внимание! Функция не создает отельный контекст интерпретатора, а использует существующий, в нем доступны все объекты и переменные, вызывающего скрипта.'' Дополнительно автоматически создается объект TSelfADO, подключенный к той же БД, что и контекст, вызвавший функцию, с пустым именем, а так же с именем "dataset".
|-
|Query(Query)
|Синоним GetSQLValue.
|-
|Close
|Закрывает набор данных.
|-
|Self
|Возвращает указатель на подключение к БД для использования в других объектах.
|-
|ParseForIn([FieldName='code'])
|Возвращает через запятую значения всех строк в указанном столбце. По умолчанию, используется столбец с именем code.
|-
|GetSQL
|Для отладки. Возвращает последний SQL запрос переданный в методы Open, Query, GetSQLValue
|-
|ExportExcel
|Для отладки. Выгружает в эксель содержимое датасета. Можно использовать в незнакомом окружении для понимания передаваемых полей в : шаблонах, печатных формах и т.д. Аналог команды %echo% в шаблонах, на случай если она не сработает.
|-
|OnGetText
|Функция подменяет текстовый вывод значения поля при выгрузке в эксель. Первый параметр это имя поля, которое надо подменить. Второй параметр это то что необходимо вывести. Работает только с текстовыми полями.
'''''Пример использования'''''
DB.OnGetText('Зона', IF((DB.FieldByName('-Lat') ! 0) * (DB.FieldByName('-Lon') ! 0),
GetPolygonByLatLon(DB.FieldByName('-Lat'), DB.FieldByName('-Lon'), 'TYPE = 1 AND IFNULL(zone, 0) > 0 AND PRICE = ' + DB.FieldByName('-price'), 'zone')
,
''
));
|}

Пример использования – см. TSelfADO

== Объект TSelfADO ==

Наследник объекта TADO. Служит для подключения к «родной» для программы, в которой выполняется скрипт, базе данных. Обладает всеми свойствами и методами объекта TADO, кроме Connect. Иногда автоматически создается системой для обеспечения простого доступа к базе данных, а также иногда создается системой с уже открытым набором данных для передачи обрабатываемого системой набора данных в скрипт. В этом случае для скрипта недоступны функции Open и Close.

Пример использования:

rem('Копируем данные из "родной" базы данных в базу MSSQL.');
new('TSelfADO', 'MyDB');
new('TADO', 'MSSQL');
MSSQL.Connect('Provider=SQLOLEDB.1;Password=myPassword;Persist Security Info=True;User ID=myUsername;Initial Catalog=myDataBase;Data Source=myServerAddress');
MyDB.Open('select code, name, passport from kurier where code>'+Int(MSSQL.Query('select max(code) from kurier'))+' order by code');
While(MyDB.EOF=0,
MSSQL.Query('insert kurier (code, name, passport) VALUES ('+MyDB.Code+', '+QuotedStr(MyDB.Name)+', '+QuotedStr(MyDB.Passport)+')');
MyDB.Next;
);

== Объект TPrinter ==

Предназначен для доступа к принтерам.

Функции:

BeginDoc – Начинает новый документ.

EndDoc – Закрывает документ

PageHeight – Возвращает высоту страницы в пикселях

PageWidth – Возвращает ширину страницы в пикселях

PageNumber – Возвращает номер текущей страницы документа

Orientation – Возвращает текущую ориентацию страницы (0 – портретная, 1 – ландшафтная)

Printing – Возвращает истину если документ открыт

SetOrientation(Orientation) – Устанавливает ориентацию страницы. При необходимости начинает новый документ, новую страницу.

ShowDialog – Показывает пользовательский диалог печати. Возвращает истину, если пользователь нажал "OK".

NewPage – Начинает новую страницу

Canvas – Предоставляет доступ к объекту TCanvas, связанному с принтером.

PrinterNames – Возвращает список принтеров, установленных в системе, разделенный переносами строк

PrintersCount – Возвращает количество установленных в системе принтеров

SetPrinter(Printer) – Устанавливает текущий принтер. Если передана строка – ищет принтер по названию, иначе – по номеру. Нумерация начинается с 0.

PrintTable(Y, Table) – Выводит на печать таблицу Table типа TTable, начиная с координаты Y. При необходимости таблица печатается на нескольких страницах. Возвращает координату Y конца таблицы.

GetDefaultPrinter - Возвращает имя текущего активного принтера.

SetDefaultPrinter(Printer) – Запоминает предыдущий активный принтер и устанавливает новый текущий принтер. Printer - имя принтера. При необходимости нескольких последовательных вызовов SetDefaultPrinter рекомендуется между вызовами использовать RestoreDefaultPrinter.

RestoreDefaultPrinter - Устанавливает активным принтер, который был текущим перед последним вызовом SetDefaultPrinter.

== Объект TCanvas ==

Предоставляет доступ к холсту объекта для прорисовки изображения.

Функции:

DPIX – Возвращает разрешение холста по горизонтали в точках на дюйм

DPIY – Возвращает разрешение холста по вертикали в точках на дюйм

TextOut(x, y, s[, x1, y1, x2, y2]) – Выводит строку s начиная с точки с координатами x и y. Если указаны параметры x1, y1, x2, y2 – то выводимый текст ограничивается заданным прямоугольником.

TextOutEx(x1, y1, x2, y2, Alignment, Font, s, Indent) – Выводит строку s в прямоугольнике с координатами x1, y1, x2, y2. По горизонтали строка выравнивается в соответствии с Alignment (0 – прижато влево, 1 – вправо, 2 – по центру), по вертикали выравнивается по центру. Используя шрифт Font (см описание ниже). Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату X фактического окончания текста (правой стороны – если строка прижата влево, и левой – в остальных случаях)

MLTextOut(x1, y1, x2, y2, Alignment, VAlignment, Font, s, Heigth, Indent) – Выводит многострочный текст s в прямоугольнике с координатами x1, y1, x2, y2 с переносом по словам. По горизонтали строки выравниваются в соответствии с Alignment, по вертикали – в соответствии с VAlignment (0 – прижато вверх, 1 – по центру, 2 – прижато вниз). Используя шрифт Font (см описание ниже). Heigth – высота строки. Если опущено или равно нулю – высота определяется автоматически в соответствии с выбранным шрифтом. Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату Y фактического окончания текста (нижней границы последней строки текста. ''ВНИМАНИЕ! Функция использует координаты прямоугольника для позиционирования текста, однако она не ограничивает его верхней и нижней границами этого прямоугольника!''

DrawPic(x1, y1, x2, y2, Pic, Style, Alignment, Mode) – Прорисовывает изображение Pic (ссылка на изображение TPicture.Self) в прямоугольник заданный координатами x1-y2. Style – стиль масштабирования. 0 – растянуть изображение до границ прямоугольника не сохраняя пропорции, 1 – вписать изображение в прямоугольник сохраняя пропорции – вероятно, останутся поля по вертикали или горизонтали, 2 – вписать сохраняя пропорции, обрезав при необходимости изображение по вертикали или горизонтали. Alignment – выравнивание по горизонтали. Работает только в случае если style=1 и при растягивании изображения получились вертикальные поля. 0 – разместить по центру, 1 – прижать влево, 2 – прижать вправо. Функция возвращает координату X правой стороны изображения кроме случая, когда Style=1 и Alignment=2 – в этом случае возвращается координата левой стороны изображения. Mode - способ наложения изображения. 0 (по-умолчанию) - копирование как есть. 1 - Наложение операцией AND (применяется для получения эффекта прозрачности изображения), 2 - наложение операцией XOR (Применяется для возможности повторной операцией убрать изображение), 3 - Наложение операцией OR.

FillRect(x1, y1, x2, y2) – Рисует прямоугольник '''без границ''' и закрашивает цветом BrashColor

Rect(x1, y1, x2, y2) – Рисует прямоугольник '''c границами''', задаваемыми текущим пером, и закрашивает цветом BrashColor

SetFont(Font) – Устанавливает шрифт по-умолчанию.

SetPen(Width, Color) - Устанавливает параметры "ручки" - толщину и цвет. Если любой параметр опустить, соответствующее значение не будет изменено.

SetBrush(Color, Style) - Устанавливает параметры заливки - цвет и стиль. Если любой параметр опустить, соответствующее значение не будет изменено. Стили заливки: 0 - сплошная, 1 - отсутствует (прозрачная), 2-7 - различные виды штриховки (горизонтальные, вертикальные, в клеточку и т.д.).

TextHeight(s) – Возвращает высоту текста s в пикселях без учета многострочности, с учетом текущего шрифта.

TextWidth(s) – Возвращает ширину текста s в пикселях без учета многострочности, с учетом текущего шрифта.

Использование шрифта (Font): У объекта TCanvas есть «глобальные» установки шрифта. Однако для некоторых функций возможно указание шрифта, отличающегося от глобального. Параметры шрифта – это текстовая строка, состоящая из 6-ти параметров, разделенных запятыми: Название, размер, жирный, курсив, подчеркнутый, цвет. Например:

'Times New Roman, 8, Y, N, N, 255'

Любой параметр можно опустить, и тогда вместо него будет использовано значение по-умолчанию: шрифт: arial, размер – 10, не жирный, не курсив, не подчеркнутый, цвет – черный. Например: ', 7' – указывает, что по-умолчанию нужно взять все параметры кроме размера шрифта. Также можно вместо всей строки указать тире ('-') или пустую строку, и шрифт будет использоваться «глобальный».

Объект можно создать отдельно, не создавая объект TPrinter. В таком случае объект создастся как ссылка на текущий холст принтера (принтер должен быть запущен и начат новый документ). Такой подход используется в доп. возможности PrintCustomSticker

== Объект TPicture ==

Предоставляет функции для работы с графическими изображениями форматов BMP, GIF, JPEG и PNG, а также для формирования штрих-кодов. Обратите внимание, прозрачность изображений не поддерживается, однако в методе TCanvas.DrawPic есть параметр Mode, призванный создавать эффект прозрачности.

Функции:

LoadFromFile(FileName) – Загружает изображение из файла FileName. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromDB(DB, Query) – Загружает изображение из базы данных. DB – ссылка на подключение к базе данных TADO.Self, Query – текст запроса. Запрос должен вернуть в первом поле первой строки BLOB-поле с изображением, все остальные данные возвращаемые запросом игнорируются. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromStr($s) – Загружает изображение из строки $s. Возвращает истину, если операция прошла успешно, иначе – ложь.

CreateBar(Width, Height, BarCode, Textless, Type) – Формирует штрих-код шириной Width и высотой Height с типом кодирования Type. BarCode – текст штрих-кода. Булево значение Textless указывает, что в штрих-коде не должно быть человеко-читаемых символов если истинно. Type указывает тип кодирования: 0 (по-умолчанию) CODE128, 1 - EAN-13, 2 - Interleaved 2-5, 3-DataMatrix, 4-QRCode.
Штрихкод должен быть: Для EAN-13 цифровым 12 или 13 символов (13-й, контрольная сумма рассчитывается автоматически), для CODE128 - должен иметь состоять из допустимого для этого кодирования набора символов. Для Interleaved - должен состоять из четного числа цифр, контрольная сумма автоматически не рассчитывается. Если для Interleaved кода указано значение из 14-ти знаков, подпись цифр выводится в формате Почты России.
Внимание! Для кодов EAN-13 и Interleaved ширина штрих-кода Width не является точным значением получаемого на выходе изображения. Ширина изображения рассчитывается как максимальное кратное минимально возможной ширине, но не меньше минимально возможной. Конечную ширину можно получить в соответствующем свойстве объекта. Для кода CODE128 штрих-код на выходе может оказаться пустым, если указанной ширины штрих-кода не достаточно для его формирования.
Для кода DataMatrix можно установить режим для печати скрытых символов с кодами 29(GS) и 232(FCN1), которые требуются для формирования Честного Знака. Для этого необходимо в начале строки указать символ "[" и все разделители 01, 21, 91, 92 так же экранировать этими скобками. Должно получиться [01]02900002317701[21]k3LInNbH_oG0Q[91]EE06[92]YXiyKfiHjE4YE8b+YVMC1O5r8VtpplA3AwcCqrcG9Dk= . При формировании кода, включится режим формирования штрих-кода DataMatrix GS1, в начале будет добавлен символ с кодом 232 (FCN1), а потом будут добавлены разделители с кодом 29 (GS)
Функция возвращает 1 в случае успеха, или текст ошибки, если такая произошла.

SetSize(Width, Height) - Устанавливает размер изображения.

AsString([ImageFormat]) - Возвращает изображение в виде строки с двоичными данными. ImageFormat принимает значения 1 - Bitmap (по-умолчанию), 2 - jpeg, 3 - png, 4 - gif.

Width – Возвращает ширину изображения.

Height – Возвращает высоту изображения.

Rotate(Angle) – Поворачивает изображение по часовой стрелке на угол Angle. Угол указывается в градусах и может принимать любые значения.

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

Canvas - ссылка на объект TCanvas холста изображения.

== Объект TTable ==

Предоставляет функции для работы с таблицами. Удобен для печати таблицы на принтере. Алгоритм таков: Загружаем датасет в таблицу, настраиваем ее (шрифты, штрих-коды и т.д.), потом выводим на принтер функцией TPrinter.PrintTable.

Функции:

LoadFromDB(DB) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Заголовок – это первая строка таблицы.

Cell(С, R) – Возвращает значение ячейки таблицы с координатами (C, R). Нумерация строк и столбцов начинается с 1.

SetCell(С, R, Value) – Устанавливает значение ячейки таблицы с координатами (C, R) в Value. Нумерация строк и столбцов начинается с 1.

RowCount – Возвращает количество строк в таблице.

ColCount – Возвращает количество столбцов в таблице.

SetTitleFont(Font) – Задает шрифт заголовка таблицы (первой строки).

SetFont(Font) – Задает шрифт всей таблицы кроме заголовка.

SetColFont(C, Font) - Устанавливает шрифт столбца C.

SetIndent(Indent) – Задает отступ от границы ячейки до текста в процентах от ширины страницы. По-умолчанию значение 0.3

SetWidth(С, Width) – Задает значение ширины столбца C в процентах от ширины страницы.

SetMinRowHeght (Heght) – Задает значение минимальной высоты строки в пикселях.

SetBarCode(Col, Type) - Указывает, что данные из столбца Col должны печататься в виде штрих-кода. Тип штрих-кода - Type. Значение '''"1" - EAN13'''. Для кода EAN13 первая строка данных в ячейке должна иметь вид "тип штрих-кода, номер", например "7, 123" (без кавычек, конечно). В этом случае система сформирует штрих-код: "2700000001233". Первая цифра - всегда 2, далее - указанный тип штрих-кода, нули, чтобы получилось 13 символов, номер, указанный в таблице, и один символ - контрольная сумма. Значение '''"2" - CODE128''' (с версии 734). Данные из первой строки ячейки таблицы печатаются в штрих-коде "как есть". Для всех видов штрих-кода (с версии 734) последующие строки печатаются под штрих-кодом в виде текста.

SetMultiHeader(Active) - Включает печать заголовка при переносе таблицы на несколько страниц. По умолчанию отключено.

SetCustomHeader(script) - Включает печать пользовательского заголовка. Script - это код интерпретатора, который должен печатать заголовок на канву. Печать таблицы может происходить на нескольких листах, по этому скрипт будет вызван для каждого листа. При использовании этого метода, автоматически инициализируются переменные: $TablePageNo - номер страницы, нумерация начинается с нуля; $TableY - координата по оси Y, от которой рисуется заголовок. Чтобы таблица была под заголовком необходимо значение переменной $TableY увеличить на высоту заголовка.

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

Пример:
<?>
NEW('TPrinter', 'Prn');
If(prn.ShowDialog,
NEW('TTable', 'Tbl');
NEW('TSelfADO', 'MyDB');
MyDB.Open('SELECT concat("7", ", ", a.code, "\r\n", a.client_id, "\r\n", a.zakaz, "-", a.number) as "Штрих-код", a.target AS "Заказик", address, phone, vlog, poruch FROM address a order by code desc limit 10');
Tbl.LoadFromDB(MyDB.Self);
Tbl.SetBarcode(1, 1);
Tbl.SetCustomHeader(
if($TablePageNo>0,
Prn.Canvas.TextOut(Prn.Canvas.DPIX*0.1, $TableY, 'Продолжение таблицы');
set($TableY, $TableY + Prn.Canvas.TextHeight('H'));
,0)
);
Prn.BeginDoc;
Prn.PrintTable(0, Tbl.Self);
Prn.EndDoc
, );

== Объект TBaseUtils ==

Предоставляет функции, базирующиеся на БД системы «MEASOFT». По-умолчанию, при создании подключается к основной базе данных модуля, в котором выполняется скрипт, если такая определена контекстом, однако это можно изменить, см SetConnection.

Функции:

'''MakeAddress(s[,town])''' – возвращает значение, полученное путем преобразований адреса s для приведения его к внутреннему формату программы. В процессе преобразования до нескольких раз происходит замена буквосочетаний по таблице замены (ее редактирование доступно по нажатию кнопки «Автозамена» в интерфейсе импорта БД из Excel системы (см. Руководство пользователя)), поиск улиц по базе КЛАДР с точностью до одного знака, и некоторые другие операции, нацеленные на исправление ошибок в написании адреса.

С версии программы 2008.0.0.615, при вызове функции в формулах загрузки реестра, в первую очередь происходит проверка строки s на условия:
* в строке s записано число;
* строка s начинается с "ПВЗ ".
Если одно из этих условий выполняется, то функция пытается установить пункт самовывоза - т.е она сама в загружаемой карточке корреспонденции укажет: адрес ПВЗ, город ПВЗ и установит галку самовывоз. Правила поиска ПВЗ:
* Если s число - считаем его внутренним кодом филиала;
* Если s начинается с "ПВЗ " - Например в адресе передана строка "ПВЗ На Ленинском проспекте", то искать будем филиал с названием "На Ленинском проспекте" который подчиненный, активный, с галкой ПВЗ и в городе town. Если город не указан, то ищем филиал во всех городах, и считаем его найденным если найдем только один филиал.
* Если филиалы найти не удалось, функция makeaddress работает как обычно и выполняет преобразование адреса.

Если адрес не содержит русских букв, только латиница, и курьерская служба находится в одной из стран Россия, Белоруссия, Казахстан или Украина, и город-получатель (второй параметр, town) находится так же в одной из этих стран, функция автоматически делает транслитерацию адреса на русский язык.

''SetConnection(DB) – Подключает объект к базе данных DB, где DB – ссылка на объект TADO.Self.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

''SetTown(Town) – Устанавливает код текущего города (используется в некоторых функциях объекта) в значение Town. По-умолчанию текущий город – 1.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

'''SetIndexLength(Length)''' – Устанавливает длину почтового индекса. По-умолчанию – 6.

'''GetIndex(Address)''' – Возвращает почтовый индекс из адреса.

'''GetStreet(Address)''' - Возвращает улицу до первой запятой.

'''GetHome(Address)''' - Возвращает номер дома до второй запятой, но не более пяти символов.

'''GetKurierByStation(station, Mass, Cash, Date_Putn)'''

'''TownByIndex(Index[, PriorityName][, PriorityCountry])''' – Возвращает код города по индексу. В случае ошибки поиска – код текущего города. Если нашлось несколько населенных пунктов, и указано приоритетное название - выбирается населенный пункт, название которого начинается с PriorityName (если есть).

'''TownByName(Name[,NotNeedCL=False, City=0])''' – Возвращает код города по имени. В случае ошибки поиска – возвратит код текущего города. Если параметр NotNeedCL (параметр не обязательный) установить в TRUE, тогда функция возвратит 0, если город не удалось найти. Параметр City (код региона) позволяет ограничить поиск одной областью (не обязательный, по умолчанию не используется).

'''FillClientInfo(Excel, client, Sheet, Row, Col)''' – Выводит в эксель информацию о клиенте с кодом client на лист sheet начиная со строки row и столбца col.

'''SavePrintFormToFile(FormType, FormNumber)''' - Сохраняет на диске файл печатной формы и возвращает путь к нему

'''CreateTrans(Address[, Store][, Operator][,Correction])''' - Формирует запись для печати кассового чека для корреспонденции с кодом Address, для выбора кассового аппарата используется код склада Store. Если Store не указано - при исполнении в среде клиентского модуля системы использует склад, указанный пользователем в окне [[Настройка параметров рабочего места|"Настройка" - "Параметры"]], в остальных модулях - код текущего склада из [[Настройка глобальных параметров|переменной]] "CL" ("Текущий филиал"). Поле Operator позволяет указать кассира (передается код справочника сотрудников). Если не указан, в основной системе будет использован код авторизованного пользователя, в других модулях - 1.
Поле Correction позволяет указать данные для корректировочного чека, используется в системе Штрих-М. По умолчанию пустая строка. Возвращает идентификаторы записей чеков. Может вернуть пустую строку, если чек создавать не понадобилось, один или несколько кодов через запятую, если создано несколько чеков. В случае ошибки вызывает ошибку, поэтому рекомендуется использовать с функцией Try.

'''CreateReturnTrans(Address)''' - формирует запись для печати чека возврата для корреспонденции с кодом Address. Чек возврата печатается на полную сумму и с теми же атрибутами, что и чек продажи. Возвращает идентификатор записи чека возврата. В случае ошибки вызывает ошибку, поэтому, как и с CreateTrans, рекомендуется использовать с функцией Try.

'''CalcTownDeliveryDays(Source, Mode, TownTo, TownFrom)''' - возвращает количество дней необходимых на доставку отправления, только для межгорода. Source - код клиента, Mode - режим срочности, TownFrom - код города отправителя, TownTo - код города получателя.

'''CalcDeliveryDate(Source, Mode, TownTo, TownFrom, Date_Beg, Time_beg)''' - Возвращает планируемую дату доставки с учетом сроков доставки. Работает при городской и междугородней доставке. Для межгорода сроки доставки берутся из зон. Для городской доставки, из дополнительных параметров статуса (17 статус, 1 параметр в доп. информации) Если рассчитать дату планируемой доставки не удалось, возвращает пустую строку. Параметры: Source - код клиента, Mode - режим срочности, TownTo - город получатель, TownFrom - город отправитель, date_beg - дата заказа (может быть передана строкой в формате DD.MM.YYYY или в числовом), time_beg - время заказа.

'''GenSpecialSMA(DirectExcel, Code)''' - функция для генерации отчета о доставке по акту передачи денег. Первый параметр - указатель на TDirectExcel, второй параметр - код акта передачи денег. АПД выводится на текущий лист объекта TDirectExcel.

'''CreateSpecialSMA(ClientCode, DateTo)''' - Функция создает исходящий акт передачи денег (АПД). Требует ClientCode - код клиента, DateTo - дату акта. Функция возвращает коды созданных актов. Если возвращаемых параметров два, значит функция пыталась создать два АПД: первым, идет код АПД с наличной оплатой, а вторым с безналичной. Примеры возвращаемого результата: '0'- акт не был создан, отсутствуют корреспонденции; '124' - код созданного акта; '0,0' - пытались создать два акта, но отсутствуют данные; '4556,0' - создан только наличный АПД; '0,445' - создан только безнал.; '4556,445' - созданы нал. и безнал.

'''CreateAddressForActDelivery(ActCode, [DeliveryDateMode=0, Delivery=True])''' - Функция создает корреспонденцию на доставку акта. ActCode - код акта; DeliveryDateMode: 0 - установить план. дату доставки текущим рабочим днем, 1 - установить план. дату доставки следующим рабочим днем, 2 - установить план. дату доставки равной планируемой дате оплаты АПД; Delivery - создать корр. на доставку АПД или создать корреспонденцию на забор АПД (по умолчанию, доставка АПД). Работа функции может быть изменена системной доп. возможностью OnCreateAddressForActDelivery.

'''CreateAddressTransferAct(ClientCode, Store, DateTo, [AdditionalParam])''' - Функция создает исходящий акт передачи корреспонденции (АПК). Требует ClientCode - код клиента, Store - код филиала, для которого будет создан акт, DateTo - дату, до которой в акт попадут возвраты, AdditionalParam - дополнительный строковый параметр для передачи в системную доп. возможность ExceptionsForAPK, позволяющий отобрать в акт, например, только полные возвраты. Возвращает код созданного акта. ВНИМАНИЕ: при создании АПК используется системная функция ExceptionsForAPK. Если в ней используются интерактивные функции (вывод сообщений, диалоговые окна, выполнение скриптов), то акт сформирован не будет, а функция CREATEADDRESSTRANSFERACT вернет ошибку.

'''GetPolygonByAddress(Address, TownCode, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попал адрес. Если полигон найти не удалось, функция возвратит пустую строку. Address - адрес корреспонденции текстом; TownCode - код города; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByAddress(addressrecord.address, if((addressrecord.number=0)*(addressrecord.strbarcode=<nowiki>''</nowiki>), addressrecord.townfrom, addressrecord.townto), '`schema`=1') - пытаемся найти вхождение адреса в полигоны 1 схемы, при выборе города учитывается корр. на забор, у нее нужно использовать город-отправитель (а для обычной корр. нужен город-получатель).

'''GetPolygonByLatLon(Lat, Lon, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попали GPS координаты. Если полигон найти не удалось, функция возвратит пустую строку. Lat - широта текстом; Lon - долгота текстом; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByLatLon('55.769064','37.590713','zone is not null and price=0') - пытаемся найти вхождение координат в полигоны, где задана зона, для всех клиентских и курьерских зон.

'''GetLatLonByAddress(AddressText, TownCode)''' - возвращает географические координаты вида lat,lon указанного в AddressText адреса. Поиск производится в городе, имеющем код TownCode в таблице Town.

'''GetRouteCode(AddressText, TownCode, LatLon[, Lon])''' - для адреса AddressText в городе с кодом TownCode (из таблицы Town) по географическим координатам lat, lon возвращает код роута (записи, хранящей координаты адреса в городе). Если роут не найден (для адреса в городе не найдено записи с указанными координатами) - создает новый роут и возвращает его код, если роут найден (был создан ранее) - обновляет у роута координаты. Если параметр Lon задан, то параметр LatLon должен содержать одну координату, иначе LatLon должен содержать строку вида 'lat, lon'.
В случае ошибки возвращает Null.

Пример: 
Set($res, GetRouteCode(address, townto, '55.114034, 36.592397')); 
Set($res, GetRouteCode('Троицк, Полковника милиции Курочкина ул., 11', 1, '37.467446, 55.740537')); 
Set($res, GetRouteCode('Обнинск, Маркса пр., 20', TownByName('Обнинск'), 55.114034, 36.592397));

'''CalcAgentPrice(AddressCode, AgentCode, TownFrom, TownTo, Mode, [, Count=1])''' - функция возвращает стоимость доставки рассчитанную по тарифу агента. AddressCode - код адреса, AgenCode - код филиала (агента), TownFrom - код города отправителя, TownTo - код города получателя, Mode - режим срочности, count - тарифная сетку от указанного количества отправлений (по умолчанию 1)

'''SetAddrKol_vo(address, getkol_vo)''' - функция делает прием корреспонденции в текущем ответственном филиале. address - внутренний код адреса, getkol_vo - количество принимаемых мест, может принимать значения: "kol_vo" - принять все места, "getKol_vo+1" - принять еще одно место, "число" - сделать количество принятых мест равным указанному числу.

'''CalcClientCnt(client_code, date, is_intown [, date_put=CurrDate(), skipajust=false])''' - функция расчета количество доставленных корреспонденций у клиента с кодом client_code за предыдущий месяц от даты date (Или за текущий месяц, подробнее смотри переменную UseCurrentMonthCount) среди внутригородских (is_intown = true) либо междугородних (is_intown = false) корреспонденций, date_put - дата доставки (для альтернативного способа подсчета, включаемого переменной UseDatePutForCalcCnt), skipajust - не учитывать принудительно введенные количества (таблица priceclientadjust типы записей 0 и 1).

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset._self".
Описание некоторых полей датасета:
pmoney - процент от суммы;
pmoneycard - процент от суммы при оплате картой;
pricecode - код прайса (таблица Price) ;
distarea - район метро получателя (актуально при отключённом едином районировании, как правило район от 200 до 299 является признаком области);
region - признак области при включенном едином районировании;
distareaFrom и regionFrom - аналог distarea, region только для отправителя;
pcncode - код записи таблицы pricecnt "количество от";
Запрос содержит поля таблицы pricelinesnew - начальная стоимость по тарифной сетки, найденные без учета массы,только по типу срочности и режиму.
Запрос содержит поля таблицы price.

*addressrecord - ссылка на объектную модель карточки корреспонденции, следует использовать уже созданную addressrecord._self
*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*type - тип корреспонденции;
*mode - режим доставки;
*wait - количество минут ожидания (не учитывается при доп. услугах, есть системная услуга "ожидание");
*mass - масса отправления;
*rur - сумма передаваемых денег (не учитывается при доп. услугах, есть системная услуга "процент от суммы");
*inshprice - сумма страховки (не учитывается при доп. услугах, есть системная услуга "процент от объявленной стоимости");
*distance - расстояние до места доставки, обычно поле заполняется при доставке в область (регион в едино районировании). Дополнительная наценка к стоимости доставки;
*forward - направление доставки: true - туда; false - обратно;
*Collection - признак заборной корреспонденции: true - забор, false - доставка (В тарифе есть возможность указать стоимость для забора);
*TownFrom - код города отправителя;
*TownTo - код города получателя.

В тарифе есть возможность указать формулу, которая может влиять на базовый расчет. Формула может объявить служебные переменные, которые:
*$FormulaReplace - если true – возвращаемое значение полностью заменяет базовый расчет;
*$FormulaKoeff - коэффициент на который будет помножена базовая стоимость.
Также внутри формулы объявлены следующие объекты dataset, addressrecord и переменные:
*$ForceIntown - Переменная становится истиной, если междугородний расчет был отменен, т.к. адрес попал в нарисованную зону на карте.
*а также: $forward, $distance, $Count, $Collection, $Wait, $FormulaKoeff, $PriceCode - описание есть выше.

Для направления "туда", Функция GetBasePrice вызывается через доп. услугу "База" (при включенных доп. услугах), для направления "Обратно" всегда вызывается напрямую (т.к. доп. услуги работают только в для направления "туда").
На расчет этой функции влияют следующие переменные: "Финансы" -> "Расчет стоимости по адресу", "Финансы" -> "Зона клиента по умолчанию", "Финансы" -> "Подсчет кол-ва отправлений за месяц".

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset.self".

*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*tp - тип корреспонденции;
*mode - режим доставки;
*mass - масса отправления;
*TownFrom - код города отправителя;
*TownTo - код города получателя.

'''CalcAddressPrice(AddressCode, [,ZakazCount])''' - полностью пересчитывает стоимость доставки корреспонденции по тарифу клиента. AddressCode - внутренний код адреса, ZakazCount - не обязательный параметр, кол-во заказов от клиента.

'''GetStationCode(s [,town])''' – возвращает код станции метро, ассоциированный в системе с адресом s. В случае невозможности идентифицировать станцию метро – возвращает 0.
Когда включено районирование по карте, необходим второй параметр "town" - код города в котором нужно искать адрес. Возвращает код района если удалось его найти; код станции меж-города - если адрес удалось геокодировать, но район не нашли; код 0 - когда не удалось геокодировать адрес.

'''RecalcSpecialSMA(ActCode)''' - пересчитать акт передачи денег (АПД). Также, у корреспонденций входящих в АПД будет пересчитана стоимость доставки. Для Входящего АПД сумма акта не пересчитывается. Параметр ActCode - внутренний код акта, коды можно перечислять через запятую.

'''UserCode''' - Возвращает код текущего пользователя из таблицы «Пользователи» (users).

'''UserName''' - Возвращает имя текущего пользователя из таблицы «Пользователи» (users).

'''UserPass''' - Возвращает пароль текущего пользователя.

'''UserBaseCode''' – Возвращает код текущего пользователя из таблицы «Сотрудники» (kurier).

'''UserEmail''' - Возвращает e-mail текущего пользователя.

'''CurrentTown''' – Возвращает код текущего города (из таблицы town).

'''CurrentCity''' – Возвращает код текущего региона (из таблицы city).

'''CurrentLocation''' – Возвращает код текущего филиала (из таблицы store).

'''FromEmailStr''' - строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

'''FillExcelDoc'''(Excel, Dataset, FormType, FormNumber,Print,[printer]) - Выполняет указанную печатную форму в объекте excel. Excel объект можно не указывать, тогда функция сама создаст объект экселя и разрушит его, полезно когда книгу
нужно распечатать или отправить по email (на листе данных в ячейке 1,1 укажите ключевое слово email). Dataset объект с данными для скрипта в печатной форме, может быть null. Dataset передавать можно так db.self, тогда переданный dataset внутри печатной формы будет доступен по имени dataset. Print - печатает книгу на принтере, после печати объект excel разрушается, при использовании параметра не указываете объект excel. Printer - имя принтера, на котором печатать (по умолчанию пустая строка, что означает "печатать на принтере по умолчанию"). Например:

new('TExcel', 'excel');
FillExcelDoc(excel.self, null, 12, 1);
excel.DoNotDestroy(true);
excel.SetVisible(true);
''Покажет эксель с выполненной печатной формой''

'''ValutaSign''' – Возвращает название валюты для суммы.

'''SendToMeasoft(xml)''' - Отправляет запрос в клиентское API Measoft. Автоматически добавляет начальный "<?xml version="1.0" encoding="utf-8"?>".

'''InsertFirmAtt(excel, sheet, firmcode)''' - Вставляем на лист эксель по коду фирмы: печать, подпись, подпись бухгалтера, логотип. Тэги <STAMP>, <DIR>, <BUH>, <LOGO> соответственно. После тега можно указать размеры изображения в символах Microsoft Excel. Формат записи: <STAMP> 16, 16

'''PreCalcSalary(kurier, addressCodes)''' - Рассчитывает предварительную зарплату. Kurier - код курьера, используется для определения тарифа. addressCodes - коды адресов, через запятую для которых необходимо посчитать зарплату. Результаты расчета будут записаны в таблицу kurierpaydetail, так как расчет предварительный то записи не будут прикреплены к конкретному начислению.

select a.code, kpd.price as "туда", kpd2.price as "обратно" from address a
left join kurierpaydetail kpd on kpd.sourcetable=3 and kpd.sourcecode=a.code and kpd.rectype = 1
left join kurierpaydetail kpd2 on kpd2.sourcetable=3 and kpd2.sourcecode=a.code and kpd2.rectype = 2
where a.code in (...)

'''CalcSalary(DateTo, [Filter=0, KurierCode = 0, ManagerCode = 0])''' - Полный расчет зарплаты курьерам. DateTo - дата до которой создается начисление. Условия отбора курьеров для начисления. Filter - роль сотрудника: 0 - Все, 1 - курьеры, 2 - менеджеры; KurierCode - код курьера, ограничить расчет зарплаты одним курьером;ManagerCode - код курьера, ограничить расчет зарплаты курьерами указанного менеджера. Внимание фильтры Filter, KurierCode и ManagerCode накладываются друг на друга. Результатом функции является SubSQL с информацией по созданным начислениям.
поля ответа: код курьера, код менеджера, начислено, бонусы, штрафы, аванс, итого;
select kurier, manager, profit, bonus, shtraf, prepay, total [union select ...]

'''SelDistAddr(s)''' – Возвращает строку для вставки в select запрос, для вывода поля с упрощенным адресом. Принимает один необязательный строковый параметр - алиас таблицы из которой будет упрощаться поле address, по умолчанию "a"

'''VoiceReadStr(str)''' – Озвучивает фразу str голосовым уведомлением доступными словами из базы. Может содержать тег "{break_off}" для того, чтобы сделать эту фразу не пропускаемой в очереди воспроизведения.

'''CalcStorageCost(ClientCodes, DateFrom, DateTo, NeedReport[, Store])''' – рассчитывает стоимость хранения на складе для выбранных клиентов (ClientCodes - коды клиентов через запятую), в период дат с DateFrom до DateTo, с прикреплением к корреспонденции отчета в зависимости от выставленного параметра NeedReport. Может содержать параметр Store - код филиала, по умолчанию пустой (расчет выполняется для всех филиалов). Возвращает коды созданных корреспонденций через запятую.

'''WriteOut(DocId, ItemId, Date, Cnt[, BC])''' – производит списание товара со склада. DocId - код (docs.code) документа списания, ItemId - код товара (item.code), Date - дата операции, Cnt - количество списываемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер. Если указан BC, то параметр ItemId игнорируется и поиск номенклатуры происходит исключительно по штрих-коду. В случае успеха, функция возвращает строку вида: код номенклатуры, списанное кол-во.

'''IncomePurch(DocId, ItemId, Date, Cnt[, BC, Location = CurrentLocation])''' – производит приход товара на склад. DocId - код (docs.code) приходной накладной, ItemId - код товара (item.code), Date - дата операции, Cnt - количество приходуемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер, Location - код склада (store.code). В случае успеха, функция возвращает строку вида: код номенклатуры, введенное кол-во.

'''CreateLedgerDoc(Date, Client, UserCode, Type[, ExtNumber, Message])''' - создает складской документ и возвращает код этого документа. Date - дата документа. Client - код клиента. UserCode - код пользователя, создавшего документ. Type - тип документа (statetype = 13). ExtNumber - номер у поставщика для документов прихода и расхода. Message - комментарий к документу. Последние два аргумента не обязательные и могут быть пустыми.

== Объект TINIFile ==

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

Функции:

IniParam(s[,section='common']) – Существует только если имя экземпляра объекта пустое. Возвращает значение параметра s ini-файла секции «common», изменить секцию можно не обязательным параметром section. В случае отсутствия параметра в файле возвращает пустую строку.

Param(s) – Синоним IniParam с тем отличием, что существует только если имя объекта непустое.

SetText(s) - Загружает ini файл из строки s. Если в файле нет секции «common», то принудительно объявляет ее в начале.

== Объект TSMS ==

Предназначен для отправки SMS, а также проверки статуса их доставки.

Функции:

SetProxy(Server, Port, User, Pass) - Устанавливает настройки прокси-сервера.

Connect(Provider, Host, User, Pass, SenderName, SMSPrefix) – Подключает объект к провайдеру provider, используя адрес Host, имя пользователя User и пароль Pass. Значение SMSPrefix предназначено для того, чтобы провайдер мог различить сообщения от разных филиалов, если этими филиалами используется одно подключение. Если необходимости разделять сообщения нет - значение SMSPrefix можно не указывать.
Для провайдера доступны значения 'mirsms', 'sms16', 'websms', 'epochta', 'zanzara', 'SMSManager', 'f1sms', 'BitCall', 'mirsmsGET', 'AMD' и другие, либо можно указать числовые значения номера протокола, от 1 до <rspoiler text="20">Набор провайдеров все время дополняется, количество и номера можно смотреть в Справочники - Переменные - Подключения - SMS</rspoiler> соответственно. Эти значения соответствуют значениям переменной SMSProtocol таблицы "Value".

SendSMS(Phone, Text, [ID]) – Отправляет SMS с текстом Text на телефон Phone. Для некоторых провайдеров необходим уникальный идентификатор сообщения ID (для провайдера iVoice - идентификатор сценария (кампании)). Возвращает ID провайдера для последующей проверки статуса доставки.

CheckSMS(ProviderID) – Проверяет состояние доставки сообщения с идентификатором ProviderID. Возвращает: 0 – доставляется, 1 – успешно доставлено, 2 – не доставлено.

ReceiveSMS(InboxID, DateFrom, DateTo, NewOnly) - Получает входящие SMS, с ящика InboxID (идентификатор выдаётся провайдером). DateFrom, DateTo - задается временной интервал в котором были приняты сообщения(формат 08.04.2013 18:00:00 'DD.MM.YYYY HH:NN:SS'). Чтобы получать только новые сообщение поле NewOnly должно быть True. Возвращает XML с сообщениями.

ExtraResult([ParamName='']) - Вызывается после CheckSMS, возвращает дополнительную информацию по последнему статусу смс. В настоящее время работает только для провайдеров BitCall и iVoice. Для BitCall по умолчанию возвращает кнопки, нажатые абонентом во время работы с голосовым меню. Если в paramname указать 'IdentifyText' то будет возвращен JSON с ответами абонента на заданные вопросы(используется в случае звонков с индивидуальным сценарием). Для iVoice по умолчанию подразумевается параметр 'response', при этом будет возвращен JSON с ответами абонента на заданные вопросы (в зависимости от сценария)

Log - Возвращает последний HTTP запрос и ответ от сервера смс.

== Объект TXML ==

Предназачен для парсинга XML-данных.

Функции:

SetText(S) – Задает текст XML документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию. Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

AttribCount – Возвращает количество атрибутов текущего элемента.

AttribName(i) – Возвращает имя атрибута с номером i.

Attrib(V) – Ищет атрибут и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

Reset – Делает текущим корневой элемент, возвращает его значение.

== Объект TJSON ==

Предназачен для парсинга JSON-данных.

Функции:

SetText(S) – Задает текст JSON документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Можно проверять наличие элементов, если элемента нет, вернется пустая строка.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

Reset – Делает текущим корневой элемент, возвращает его значение.

isArray - Возвращает true, если текущий элемент является массивом (доступ к дочерним элементам возможен только по индексу, нумерация элементов начинается с нуля)

==Объект TZip==
Предназначен для работы с Zip архивом.

SetZip(s) - Загружает архив в объект из строки s;

GetZip - Возвращает архив в виде строки;

AddFromFile(SrcPath, ZipPath) - Добавляет файл SrcPath в архив и располагает его по пути ZipPath. ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

AddFromStr(Data, /*ZipPath*/) - '''параметр ZipPath временно не работает'''. Добавляет файл из строки Data в архив и располагает его по пути ZipPath. -ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

LoadFromFile(path) - Загружает архив из файла path;

SaveToFile(path) - Сохраняет архив в файл path;

Count - Возвращает кол-во файлов в архиве;

DataByIndex(index) - Возвращает распакованный файл в виде строки. Index - номер файла в архиве;

DataByName(ZipPath) - Возвращает распакованный файл в виде строки. ZipPath - путь к файлу в архиве, может содержать каталоги;

FileName(index) - По номеру файла, функция возвращает полный путь файла в архиве.

==Объект TBase==

'''Функции общего назначения''':

'''ExecSimpleScript(Caption, Text)''' - Выполняет скрипт "Дополнительных возможностей". Возвращаемые значения, введенные пользователем устанавливает в переменные $scriptvar1..$scriptvarN, Значения кодов списочных переменных - в переменных $scriptvar1codes..$scriptvarNcodes. Функция возвращает истину, если пользователь нажал "OK" в диалоговом окне.

'''FillAdvPriceReport(Excel, AddressCodes, StartLine, StartCol, [ShowSumPrice,InsertColumns,ShowAll])''' - добавляет отчёт по дополнительным услугам. В AddressCodes - указаны коды адресов через запятую, каждый код это отдельная строка отчета. Адреса будут показаны в порядке перечисления их в AddressCodes. Если в отчет нужно добавить пустую строку, то можно указать код адреса -1000. StartLine, StartCol - верхний левый угол выгружаемой таблицы. ShowSumPrice - добавить столбец итоговый столбец с суммой всех услуг, по умолчанию выключено. InsertColumns - раздвинуть таблицу перед вставкой отчета, позволяет встраивать отчет посередине выгрузки, по умолчанию выключено. ShowAll - показать все дополнительные услуги, по умолчанию false и показывает только услуги с начислениями. Функция возвращает количество использованных столбцов.

'''PrintSticker(Codes, [ToBoxes=False])'''

'''PrintBlanc(Codes, BlancNumber)''' - печатать форму из раздела "Заполнить бланк". Codes - коды корреспонденций, BlancNumber - номер формы из раздела "Бланки для корреспонденции" (3)

'''GetItemByName(Name)'''

'''GetA4Printer([GetPrinterPort=False])''' - возвращает имя принтера выбранного для печати документов. GetPrinterPort - попытаться по имени принтера найти порт принтера. Определение порта работает только с физическими устройствами LPT, USB, TCPIP.

'''GetStickerPrinter([GetPrinterPort=False])''' - возвращает имя принтера выбранного для печати стикеров. GetPrinterPort - попытаться по имени принтера найти порт принтера. Определение порта работает только с физическими устройствами LPT, USB, TCPIP.

'''GetDuplexPrinter([GetPrinterPort=False])''' - возвращает имя принтера выбранного для двусторонней печати, если принтер не выбран, возвращает пустую строку. GetPrinterPort - попытаться по имени принтера найти порт принтера. Определение порта работает только с физическими устройствами LPT, USB, TCPIP.

'''PrintAttachPDFPage(Code, FileName, Page, Printer)''' - печатает страницу из вложенного файла PDF. Code - код вложения (attachment) или путь к файлу, Page - номер страницы, Printer - 0 = принтер A4, 1 = принтер этикеток.

'''AttachPDFToText(Code, [TextFileName])''' - преобразует файл PDF из вложений в текст. Code - код вложения (attachment) или путь к файлу, TextFileName - имя текстового файла, в который записывается результат (если не указан, используется временный файл). Возвращает текст в виде строки.

'''GhostScript(GScript, Code)''' — функция для выполнения консольных команд утилиты [https://ghostscript.readthedocs.io/en/latest/Use.html ghostscript]. Где, GScript — строка с командами Ghostscript; Code — код вложения или путь к PDF-файлу, предназначенному для обработки. В командах доступен специальный тег %MeasoftInFile%, который автоматически заменяется на путь к предварительно загруженному файлу (Code). Если в команде необходимо указать путь для сохранения результата обработки, используйте тег %MeasoftOutFile%. В этом случае функция на основании параметра Code автоматически сформирует имя временного выходного файла. После успешного выполнения команд функция возвращает путь к сгенерированному выходному файлу - %MeasoftOutFile%.

'''GetActiveForm([SkipFormName])''' - возвращает код активной формы в программе где происходит сканирование. SkipFormName - не обязательны параметр, имя формы которую нужно пропустить при определении интерфейса.
'''Список интерфейсов''':
0 - неопределенный;
1 - прием корреспонденции на склад;
2 - АПД;
3 - комплектация адресов (ShelfingForm);
4 - доска приема;
9 - вкладка «Манифесты»;
10 - Инвентаризация корреспонденции;
11 - АПК;
12 - вкладка «Адреса»;
13 - вкладка «Выдача»;
14 - вкладка «Склад»;
15 - Список номенклатуры;
16 - Инвентаризация склада;
17 - Приходная накладная;
18 - Списание товара;
19 - Карточка корреспонденции.

'''AddAddressScanLog(Code[, StrBarCode, IsManual, FromInterface, ExtraInfo])''' - добавляет событие сканирование для корреспонденции с кодом Code. Необязательные параметры: StrBarCode - сканируемый ШК корреспонденции (по умолчанию пустой), IsManual - галка ручного сканирования (по умолчанию false), FromInterface - код интерфейса сканирования (StateType=81, по умолчанию 0 - неопределенный), ExtraInfo - текстовый комментарий события.

'''RuleName(alias)''' - Выдает полный путь в дерева прав по псевдониму права.

'''ShowText(Caption:string, Value:string)''' - показывает пользователю окно с заголовком Caption и с многострочным полем со значением Value. Может быть полезен при отображении логов выполненной операции.

'''ShowScanError(msg [, Speek, Color, Abort])''' - выдает пользователю окно с текстом msg блокируя последующие действия сканирования. Если Speek - истинно, то сообщение проговаривается голосовым движком, по умолчанию выключено. Color - целочисленное число цвета, в который будет окрашен фон сообщения (по умолчанию = -1, стандартный). Abort - прервать выполнение скрипта, не показывая ошибку.

'''CheckRule(alias)''' - функция проверки разрешения у текущего пользователя системы, alias - псевдоним права. Возвращает 1, если право есть и 0, если права нет.
Пример: if(CheckRule('RSE'), ShowMessage('У пользователя есть право изменять счета'), ShowMessage('У пользователя нет права изменять счета'));

'''GetKurierMoney(KurierCode, DateEnd, NonCash)''' - возвращает баланс курьера с кодом KurierCode на дату DateEnd. NonCash - булевый флаг, если истинно, то будет рассчитан безнальный баланс;

'''Функции, работающие только в импорте БД из эксель:'''

ReplaceAddress

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

GetPrice

GetNewNumber - используется при импорте реестра, возвращает номер конверта в загружаемом заказе

GetNewPos - используется при импорте реестра, возвращает порядковый номер вложения

GetNewPackagePos- используется при импорте реестра, возвращает порядковый номер места

Zakaz - возвращает номер заказа куда происходит импорт реестра

addresscode - используется при импорте реестра, код созданного адреса

Source - код заказчика

ClientTown - Узнаем город клиента, через филиал с которым он работает. Сам клиент берется из заказа указанного в окне "Импорт БД из Excel".

== Объект TFieldObject ==
Создается только автоматически. Объект для доступа к записям, используется в картах и дополнительных услугах (addressrecord) и событиях карточки корреспонденции (fieldlist). Методы объекта:

'''_GetTableInfo''' - возвращает данные о полях и примеры данных объекта.

'''_Self''' - возвращает ссылку на объект.

'''_Set(fieldname, fieldvalue [, DoUpdateForm])''' - Если базовый объект строка. Устаналивает для поля fieldname значение fieldvalue. DoUpdateForm по уолчанию false, если указать true то обновление поля будет не только в объекте но и пользовательском интерфейсе. Обновление работает только в карточке корреспнденции для ограниченного набора полей: vlog, mode, type, date_put, time_put, message, kurier, state1.

'''_Set(keyfield, keyvalue, filed, value)''' - Если базовый объект таблица (addressrecord.boxes). Работает перегруженная версия метода _set, cначала происходит поиск строки по ключу, далее меняется значение указанного столбца. keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Пример, отключение услуги база:

addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

== Объект TMessage ==
Создается только автоматически. Объект используется для скриптовой обработки письма в [https://wiki.courierexe.ru/index.php/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F_%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8#.D0.98.D0.BC.D0.BF.D0.BE.D1.80.D1.82_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85| заданиях импорта данных]. В себе содержит текст письма в очищенном формате и оригинальном формате HTML, отправитель письма, тему письма, дата получения и список прикрепленных файлов.

'''Message.Text''' - возвращает очищенный от HTML-тегов текст письма.

'''Message.HTMLText''' - возвращает оригинальный текст письма со всеми HTML-тегами.

'''Message.Sender''' - возвращает email-адрес отправителя письма.

'''Message.AttachmentsCount''' - возвращает количество вложенных файлов.

'''Message.DateTime''' - возвращает дату и время получения письма.

'''Message.Subject''' - возвращает тему письма.

'''Message.GetAttachmentDataString(Number)''' - возвращает вложенный файл под номером Number в виде строки.

'''Message.GetAttachmentName(Number)''' - возвращает имя вложенного файла под номером Number.

== Объект TStringList ==
Может использоваться для построчной обработки многостраничных файлов либо для организации текстовых данных. Номер строк начинается с 0.
Имеет следующий функционал:

'''Count''' - возвращает количество строк в списке.

'''Add(Value:string)''' - добавляет значение Value в конец списка.

'''SetText(Value:string)''' - устанавливает значение списка в значение Value.

'''Insert(Number:integer, Value:string)''' - добавляет строку Value в позицию Number.

'''Delete(Number:integer)''' - удаляет строку из списка в позиции Number.

'''Clear''' - очищает элементы списка.

'''LoadFromFile(Path:string)''' - загружает текстовый файл по пути Path.

'''Strings(Number:integer)''' - возвращает строку с номером Number.

'''SetString(Number:integer, Value:string)''' - устанавливает значение строки с номером Number в значение Value.

'''Text''' - возвращает полный список строк в виде текста.

'''CommaText([Quoted:boolean])''' - возвращает список значений через запятую. Если Quoted = true, то квотирует элементы списка. По умолчанию равен false.

'''SetCommaText(Value: string)''' - разбивает значение Value на отдельные строки и кладет в список. Разделитель - запятые.

'''IndexOf(Value:string)''' - ищет значение Value среди элементов списка и если находит, то возвращает номер строки. Возвращает -1 если значение не было найдено.

'''Sorted(Value:boolean)''' - устанавливает флаг отсортированности списка в Value. Если Value = true, то сразу же его сортирует. По умолчанию Value = false.

'''Exchange(Pos1:integer, Pos2:integer)''' - меняет элементы списка с позициями Pos1 и Pos2 местами.

'''Duplicates(Value:integer)''' - изменяет параметр управления дубликатами в списке. Если Value = 0 (значение по умолчанию), то список не реагирует на дубликаты. Если Value = 1, то список при добавлении будет игнорировать дубликаты. Если Value = 2, то список будет выдавать исключение, при добавлении дубликата в список.

'''ParamName(Number:integer[, Delimiter:string])''' - возвращает текст до первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает пустоту.

'''ParamValue(Number:integer[, Delimiter:string])''' - возвращает текст после первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает всю строку.

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

Основные методы:

'''New'''(FuncName, Param1, Param2, ..., Body) — создание новой функции.Функция возвращает результат выполнения последней команды в теле функции. Аргументы:
* `FuncName` — имя функции (строка)
* `Param1, Param2, ...` — имена параметров функции (переменные начинаются с `$`, объекты — без префикса)
* `Body` — тело функции (скрипт, выполняемый при вызове)

'''FuncName'''(Arg1, Arg2, ...) — вызов созданной функции по имени. Если в объявлении была указана тип переменная, то и подставлять в аргумент надо обязательно переменную. Будет передано значение этой переменной (переменные словарине поддерживаются!). Если был объявлен объект, то указатель на объект должен быть получен через метод '''_self'''. C функциями поддерживают работу следующие классы: TExcel, TDirectExcel, TCSVFile, TADO, TSelfADO, TPrinter, TCanvas, TPicture, TTable, TINIFile, TSMS, TXML, TJSON, TZip, TStringList, TBaseUtils, а также объект addressrecord (TFieldObject). Результатом работы функции может быть число или строка.

Пример 1, обработка результатов функции:
<source>
<?>
new('TFunc', 'calc');
calc.new('Sum', '$a', '$b',
$a + $b
);

set($x, 10);
set($y, 20);
showmessage(calc.Sum($x, $y));
</source>

Пример 2, передача объекта в функцию:
<source>
<?>
new('TFunc', 'utils');
utils.new('ProcessDB', 'dbConn', '$value',
showmessage($value);
dbConn.open('SELECT * FROM address limit 3 ');
if(dbConn.recordcount > 0,
showmessage('Найдено записей: ' + dbConn.recordcount);
dbConn.first;
while(dbConn.eof = 0,
showmessage(dbConn.fieldbyname('code'));
dbConn.next
)
,0)
);

new('TSelfADO', 'db');
utils.ProcessDB(db._self,'test!');
</source>

== Применение языка формул ==
'''в различных контекстах системы «MEASOFT» и сопутствующих проектах'''

=== MEASOFT ===

==== Дополнительная информация на чеке ====

В карточке клиента на закладке «Касса» имеется поле для ввода текста, который будет отображаться на кассовых чеках, печатаемых для корреспонденции от данного клиента. В поле может быть введен как просто текст, так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TSelfDB с открытым набором данных со строчкой корреспонденции, заказа и клиента, на которую печатается чек

TBaseSupport

TBaseValue

Все объекты создаются с пустыми именами.

Так же система записывает в переменную $CashRegisterID вычисленный код фискального регистратора, на котором предполагается печать чека.

Результат работы скрипта печатается на создаваемом чеке, если скрипт не возвращает значение “-1” (число или текст) – в этом случае система чек не создает. Подразумевается, что либо скриптом было принято решение об отсутствии необходимости формирования чека, либо скрипт взял эту функцию на себя.

==== Заполнение шаблонов печатных форм ====

==== Дополнительные возможности ====

==== Импорт БД из Excel ====
В окружении интерпретатора создается объект ZakazRecord, он является списком со значениями таблицы zakaz. Именно в этот заказ будут загружены данные. Из этого объекта также доступно : 
*ZakazRecord.userfields - пользовательские поля заказа;
*ZakazRecord.Clients - данные таблицы clients;
*ZakazRecord.Clients.userfields - пользовательские поля заказчика.

==== Прайс лист клиента ====

Формула возвращает сумму в валюте клиента для каждой поездки (туда или обратно) единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Помимо стандартных объектов, система создает объект AddressRecord, в котором, как свойства, доступны все поля текущей записи. Так же она выставляет значение переменной $Forward в 1 (истина), если необходимо произвести расчет для направления "Туда" и 0 (ложь) - если обратно. ВНИМАНИЕ! Как и во всех остальных местах, после формулы нельзя ставить ";", иначе скрипт вернет 0!

Например:

if(int(AddressRecord.Time_Put_Max)>19, 100, 0)

''Прибавляет 100 рублей в случае, если максимальный срок доставки 20 часов или более''

if(pos(AddressRecord.Address, 'Аренда')>0,
set($FormulaReplace, 1);
1500
, 0)

''В случае наличия подстроки "Аренда" в адресе заменяет штатное ценообразование на 1500 рублей''

Объект AddressRecord может предоставить доступ к связанным таблицам :
* addressrecord.boxes
* addressrecord.packages
* addressrecord.clients
* addressrecord.price
* addressrecord.advprice
* addressrecord.userfields
* addressrecord.addressfld
* addressrecord.clients.userfields
* addressrecord.price.userfields
* addressrecord.zakaz
* addressrecord.zakaz.userfields

Чтобы получить доступ к полю VarCode из таблицы userfields необходимо записать AddressRecord.Userfields.VarCode. В присоединённой таблице может быть несколько записей чтобы получить к ним доступ предусмотрены функции _First, _EOF, _Next, _RecordCount, _Set.

Пример:
set($value1, 0); set($value2, 0);
while(AddressRecord.userfields._EOF=0,
if(AddressRecord.userfields.varCode=1,
set($value1, if(AddressRecord.userFields.VarValue='Праздничная упаковка', 150, 0)), ''''''');
if(AddressRecord.userfields.varCode=2,
set($value2, AddressRecord.userFields.VarValue), ''''''');
AddressRecord.userFields._Next;
);
int($value1) + int($value2)

Пример делающий тоже самое что и выше но через поиск Locate:
set($value1, if(addressrecord.userfields.VarValue('VarCode', 1)='Праздничная упаковка', 150, 0));
set($value2, int(addressrecord.userfields.VarValue('VarCode', 2)));
$value1 + $value2

В скрипте доступны переменные:
«$FormulaKoeff» - это коэффициент на который умножится конечная цена (по умолчанию равна 1);
«$PriceCode» - код прайса;
«$CurrentPriceConf» - код услуги;
«$BasePrice» - стоимость всех услуг с уровнем (pricelevel) меньше текущего.

Для вызова функции CalcBasePrice (Расчёт базовой цены) в скрипте объявленны переменные: $Count,$Collection,$Distance,$Wait.

Существует поиск по ключевому полю (поиск регистронезависимый), например чтобы найти в таблице advprice введённое значение для текущей услуги, нужно сделать такую запись addressrecord.advprice.value('priceconf', $CurrentPriceConf) - Первый параметр это ключевое поле, второй искомое значение. Если запись найдётся будет возвращено значение поле value, если нет функция вернёт значение 0.

Пример
if(addressrecord.advprice.active('priceconf', 3)='T', addressrecord.advprice.price, 0)

''Смотрим включена ли услуга и если да, возвращаем рассчитанную стоимость

Чтобы изменить значение записанное в объект addressrecord, нужно воспользоваться методом _set(keyfield, keyvalue, filed, value). Параметр keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Сначала происходит поиск строки по ключу, далее меняется значение указанного столбца.
Пример, отключение услуги база:
addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

Также существует упрощенный метод _set, с двумя параметрами filed, value - он используется в шаблонах загрузки или в системных доп. возможностях где доступен объект addressrecord.

==== Зарплата курьеров ====

Формула возвращает сумму в основной валюте для каждой единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Переменные «$FormulaTablKoeff» и «$FormulaMoneyKoeff» позволяют установить повышающий или понижающий коэффициент на стоимость доставки (по тарифной сетке) и услуги соответственно (процент от суммы, процент от стоимости доставки, ожидание). Переменная «$UsingZoneName» и «$KurierZone» содержат название и код зоны соответственно, есть возможность поменять название зоны для отчета.

=== Планировщик ===

В поле текста задания может быть введен как текст с командами планировщика (см ниже), так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TIniFile, Указывает на настроечный ini-файл планировщика.

Все объекты создаются с пустыми именами.

Для записи в лог планировщика нужно использовать функцию Print

=== Репликатор ===

== Прочее ==
ReplaceAddress(target, address) – Возвращает адрес последней доставки корреспонденции получателю target по адресу address от текущего клиента. При отсутствии такой доставки, возвращает address.

GetPrice –возвращает рассчитанное значение цены, на основе прайс-листа клиента и данных о корреспонденции.

GetKurierByStation(i) – возвращает код курьера, ассоциированного со станцией метро с кодом i.

GetNewNumber – Возвращает не занятый номер единицы корреспонденции в текущем заказе.

==История изменений==

=== Недавние изменения ===
{|
||'''Изменено:'''
|2026.0.0.550 Доработка функций интерпретатора GetA4Printer, GetStickerPrinter, GetDuplexPrinter.
|-
||'''Изменено:'''
|2026.0.0.547 Доработка функций ATTACHPDFTOTEXT и PRINTATTACHPDFPAGE, добавлена возможность указать путь к файлу
|-
||'''Добавлено:'''
|2025.0.0.539 Добавлена поддержка отладчика AttachDebugger
|-
||'''Добавлено:'''
|2025.0.0.534 Добавлена поддержка оператора CASE и класса TFunc
|-
|}

=== Версия 2021.0.0.57 от 18.06.2019 ===
{|
||'''Добавлено:'''
|В объект TExcel добавлен метод ColumnDelete.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция InsertFirmAtt.
|-
||'''Добавлено:'''
||В объект TExcel добавлен метод Align.
|-
||'''Добавлено:'''
|Функция CheckEan
|-
||'''Добавлено:'''
|В объект функцию FillAdvPriceReport добавлены параметры ShowSumPrice,InsertColumns
|-
||'''Добавлено:'''
|В объект TSMS добавлен метод Log.
|-
||'''Добавлено:'''
|Добавлена функция Money.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция ValutaSign.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция GetPolygonByLatLon.
|-
||'''Добавлено:'''
|В объект TTable добавлена функция SetMultiHeader, SetCustomHeader.
|-
||'''Добавлено:'''
|Функция DownloadAttachment
|-
||'''Добавлено:'''
|В функцию SetRowHeight объекта TExcel добавлен параметр cnt.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция AsString.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция SetSize.
|-
||'''Добавлено:'''
|В объект TADO добавлена функция ParseForIn.
|-
||'''Изменено:'''
|В объект TBaseUtils из TBase перенесена функция FillExcelDoc.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция CalcAddressPrice
|-
||'''Изменено:'''
|Все функции класса TBaseSupport перенесены в TBaseUtils. Класс TBaseSupport больше не существует.
|-
||'''Добавлено:'''
|В функции RowInsert и RowDelete объекта TExcel добавлен параметр count.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция SendToMeaSoft
|-
||'''Добавлено:'''
|В объект TBaseUtils функция RecalcSpecialSMA
|-
||'''Добавлено:'''
|Новая функция Reverse
|}

=== Версия 849   22.02.2018 ===

{|
||'''Добавлено:'''
|В функцию TBaseUtils.TownByIndex добавлен параметр PriorityName
|-
||'''Добавлено:'''
|В объекте TBase добавлена функция GetNewPackagePos
|-
||'''Добавлено:'''
|В объекте TSMS доработан метод ExtraResult, добавлен параметр ParamName
|-
||'''Добавлено:'''
|В объект TBase добавлена функция CalcAgentPrice
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateAddressForActDelivery
|-
||'''Изменено:'''
|Функция CalcTownDeliveryDate заменена на CalcDeliveryDate
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateSpecialSMA
|-
||'''Добавлено:'''
|Функция SignatureUrl
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция LoadFromStr.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetPen.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetBrush.
|-
||'''Добавлено:'''
|В объект TPicture добавлена поддержка чтения в формате PNG.
|-
||'''Добавлено:'''
|В функцию TCanvas.DrawPic параметр Mode
|-
||'''Добавлено:'''
|Свойство TPicture.Canvas
|-
||'''Добавлено:'''
|Функция DeleteFile
|}

=== Версия 758   29.03.2017 ===
{|
||'''Добавлено:'''
|Функция GetPolygonByAddress
|-
||'''Добавлено:'''
|Функция ParamsCount
|-
||'''Добавлено:'''
|Объект TZip
|-
||'''Изменено:'''
|Функции CreateEAN и Create128 заменены одной функцией CreateBar, полностью совместимой с Create128, но добавлена поддержка EAN-13 и Interleaved 2-5 (для Почты России). В системе функции оставлены для обратной совместимости, но более не являются документированными и рекомендованными к использованию.
|-
||'''Добавлено:'''
|Параметр text в функцию Cell объекта TExcel
|-
||'''Добавлено:'''
|Функция UrlEncode
|-
||'''Добавлено:'''
|Функция IncDay теперь может принимать параметр count
|-
||'''Добавлено:'''
|Функции FtpGet, FtpPut, TTable.SetCell()
|}

=== Версия 452   26.02.2014 ===

{|
||'''Добавлено:'''
|Функция Time
|-
||'''Добавлено:'''
|Функция FixedIntToStr
|-
||'''Добавлено:'''
|Функция TimePeriod
|-
|'''Добавлено:'''
|В интерпретатор добавлена функция приёма смс - ReceiveSMS
|-
|'''Добавлено:'''
|Функция STR2UTF
|-
|'''Добавлено:'''
|Функция SAVETOFILE
|-
|'''Добавлено:'''
|Функция TExcel.SetSheetName
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "FILESTR"
|-
|'''Добавлено:'''
|Расширены возможности объекта addressrecord в формулах тарифов
|}

=== Версия 308   24.11.2012 ===

{|
|'''Добавлено:'''
|В функции загрузки таблиц из TADO добавлено условие, что поля, названия которых начинаются с "-" не выгружаются. Таким образом можно скрывать служебные поля из результирующего набора.
|-
|'''Добавлено:'''
|Функция TExcel.RowAutoFit
|-
|'''Добавлено:'''
|Функция TExcel.RowInsert
|}

=== Версия 300   01.11.2012 ===

{|
|'''Добавлено:'''
|В объекте TCSVFile добавилась возможность запрашивать значения не только текущей записи через параметр сдвига
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "UPDOWN"
|-
|'''Добавлено:'''
|В интерпретатор добавлен объект TCSVFile
|}

=== Версия 266   14.09.2012 ===

{|
|'''Добавлено:'''
|В интерпретатор добавлена поддержка массивов
|}

=== Версия 265   11.09.2012 ===

{|
|'''Добавлено:'''
|Функция CreateTrans в интерпретатор
|-

Оборудование

2026-01-16T06:50:30Z

Sammy: /* Аппаратные требования к рабочей станции */

== Аппаратные требования к рабочей станции ==
* Работа под управлением ОС Windows 32/64 Bit: Win7, Win8; Win10; Win11.
* Установленный и активированный пакет Microsoft Office 2007 или выше '''кроме «Office 2010 Starter»'''.
* Процессор: любой, удовлетворяющий рабочим требованиям линейки ОС Windows.
* Оперативное запоминающее устройство (ОЗУ): от 2 Gb и выше.
* Запоминающее устройство HDD или SSD: от 60 GB и выше.
* Сетевой интерфейс: проводной/беспроводной Ethernet интерфейс.
* Монитор: диагональ, обеспечивающая разрешающую способность экрана не менее 1024*768 пикселей.
* Периферийные порты ввода-вывода USB, RS232 (при необходимости наличия таковых): для подключения периферийного оборудования (сканер штрихкодов, фискальный регистратор, термопринтер).
* Клавиатура, манипулятор мышь.

== Выбор сервера для системы ==

=== Выбор серверного оборудования ===
Система MeaSoft нетребовательна к аппаратным ресурсам сервера.

Что касается '''производительности''', то для небольшой компании, человек 10 в офисе, как правило, производительности бытового ноутбука, установленного в качестве сервера, будет более, чем достаточно. То есть серверную часть можно установить на любую машину, за которой работает пользователь. Для компаний до 20 сотрудников мы рекомендуем использовать бытовой компьютер, но «назначенный» сервером, то есть чтобы он стоял отдельно работал круглосуточно, и им никто не пользовался в качестве рабочей станции. Для компаний более 20 человек — лучше использовать именно серверное оборудование, хотя у нас есть установка, где на бытовом Core i3 одновременно работает 80 человек.

'''Объем диска''': Изначально при установке БД занимает около 1 Gb. Далее она увеличивается в зависимости от использования. Если компания доставляет 20000 отправлений в месяц, через 3 года объем базы будет 10 Gb с одной оговоркой: Больше всего места в БД занимают файлы, такие, как архив отсканированных накладных, отправленные по почте отчеты и счета, и т. д. Здесь, если компания использует эти возможности, она за год может накопить и 100 и 200 Gb. Так же необходимо учитывать некоторый объем свободного места, необходимый для создания резервных копий, а так же для работы самой ОС.

Самое главное требование системы к серверу — это его '''надежность'''. Надо понимать, что при поломке сервера приостановится работа всей компании. В худшем случае — можно потерять данные, введенные с момента последней резервной копии. Для сокращения возможных рисков, нужно стараться, по возможности, делать сервер максимально надежным:

* Мы не рекомендуем устанавливать сервер на ноутбук, так как его форм-фактор предполагает некоторую степень мобильности. Есть соблазн взять его куда-то с собой. А при перемещении велик риск его потери, кражи, его можно уронить и разбить. Еще один фактор низкой надежности ноутбуков — они часто умирают от пролитого на них чая/кофе/пива.
* Мы не рекомендуем устанавливать серверную часть на компьютер, за которым работает пользователь. Здесь главный фактор риска — это заражение компьютера вирусами, которые пользователь, по неграмотности, скачивает из интернета, приносит на флешках и т. д. Антивирус никакой от этого не спасает.
* Мы рекомендуем устанавливать на серверный компьютер [https://ru.wikipedia.org/wiki/RAID Raid-1] массивы для снижения вероятности выхода из строя/потери данных в случае поломки жесткого диска. Однако нужно понимать, что это тоже не панацея: жесткие диски достаточно часто выходят из строя все одновременно, например, при поломке блока питания, когда напряжение «пробивает» через него и приводит к выгоранию всех компонентов компьютера, В случае стихийных бедствий и несчастных случаев (прорывы в трубах, например), или просто от того, что 2 HDD одной модели, купленные одновременно имеют одинаковый ресурс наработки на отказ.
* Мы рекомендуем устанавливать [https://ru.wikipedia.org/wiki/Источник_бесперебойного_питания ИБП] на сервер для предохранения его от скачков напряжения в сети и/или аварийного завершения работы при отключении питания.
* Мы рекомендуем использовать специализированное серверное оборудование, так как оно по определению гораздо надежнее, вплоть до резервирования блоков питания. Но такое оборудование достаточно дорогое, и его использование носит исключительно рекомендательный характер.

Некоторые наши клиенты не удовлетворяются вышеизложенными рекомендациями по выбору серверного оборудования и просят нас предоставить формальные требования к серверу. Вот они:

1. Работа под управлением ОС Windows 2012 Server R2; 
2. Процессор: многоядерный, удовлетворяющий требованиям ОС; 
3. Оперативное запоминающее устройство (ОЗУ): от 4 GB; 
4. Запоминающее устройство HDD: от 360 Gb, Raid-1; 
5. Сетевой интерфейс: проводной Ethernet интерфейс — 100 Mbit.; 
6. Монитор, с разрешением минимум 1024*768; 
7. Клавиатура microsoft минимум 103 клавиши; 
8. Мышь оптическая; 
9. Колонки активные минимум 2 Вт; 
10. Коврик для мыши силиконовый :-) 

=== Выбор серверной операционной системы ===
Серверная часть MeaSoft работает практически на любой операционной системе. Исключение — модуль интеграции с внешними системами.

При выборе ОС нужно рассмотреть все плюсы и минусы. Обычно выбор стоит между Windows и Linux.

Windows — платная система. Серверная Windows стоит 40-45 т.р. Система прекрасно работает, например, на Windows 7 (желательно только не домашнюю версию), которая стоит в разы меньше. Ограничение на количество подключений к ней не имеет отношения к нашей системе.

Linux — «бесплатная» система. Почему в кавычках? Потому что стоимость владения им гораздо выше: для администрирования системы linux необходим системный администратор с глубокими познаниями этой ОС, а такие специалисты стоят в 2 раза дороже, чем администраторы Windows.

Таким образом даже «дорогая» серверная Windows окупается за пару месяцев. Linux можно выбирать только в том случае, если в вашей компании и так уже работает несколько системных администраторов Linux, которые смогут решать возможные проблемы с ней. Наша компания оказывает необходимую для работы системы помощь в администрировании windows-серверов, но с linux эта функция полностью ложится на заказчика. Почему мы говорим, что должно быть несколько администраторов в случае с Linux? Потому что в случае увольнения единственного администратора, как правило, компанию ждут времена несчастий, пока не найдется новый ТОЛКОВЫЙ системный администратор.

Резюме: Выбирайте Linux только в том случае, если вы точно уверены в том, что делаете. В противном случае — только Windows.

=== Размещение сервера ===
Для классической архитектуры системы, когда офис-склад консолидированы в одном месте, мы рекомендуем размещение сервера в офисе. То есть в точке максимального использования системы. Это обеспечивает максимальную скорость и надежность. При этом при необходимости удаленного доступа к системе — достаточно, имея внешний статичный IP-адрес, «пробросить» порт 3306 на сервер.

В последнее время все больше популярность приобретает размещение сервера «в облаке». На самом деле формально — это, конечно, не [https://ru.wikipedia.org/wiki/Облачное_хранилище_данных облако] в широком понимании, а [https://ru.wikipedia.org/wiki/VPS сервер], физический или виртуальный, находящийся в дата-центре. При выборе такого варианта установки программы следует учесть ряд факторов:
* '''Скорость доступа''' Наша система очень чувствительна к скорости доступа. Некоторые операции могут вызывать несколько обращений к серверу, и увеличение времени одного обращения на несколько миллисекунд существенно снижает общую производительность системы на рабочем месте. При размещении сервера в дата-центрах Европы, например, скорость доступа ([https://ru.wikipedia.org/wiki/Ping ping]) из Москвы составляет 50-60 мс. Это — на грани возможности использования программы. При размещении в дата-центре того же города, где находятся пользователи, время доступа — порядка 3-5 мс. Для сравнения — доступ по локальной сети — менее 1 мс.
* '''Надежность интернет-канала''' Нужно понимать, что в случае размещения сервера в интернете система не будет работать у вас в офисе и/или на складе в случае отсутствия доступа в интернет. Желательно обеспечить резервирование канала, причем, желательно, не 3G-«свистком» (см. следующие 2 пункта).
* '''Пропускная способность интернет-канала''' При разработке системы мы стараемся минимизировать объемы информации, передаваемые между рабочим местом и сервером. Но если доступ происходит через интернет, на одном канале работает несколько человек, на котором работает и программа и телефоны, а кто-то смотрит видео в ютубе, а кто-нибудь еще придумает пользоваться торрентами — работа остановится.
* '''Стабильность интернет-канала''' При доступе к серверу не должны теряться пакеты. Если на канале происходят потери — программа будет закрываться с сообщением о том, что произошла потеря соединения с сервером. Потери пакетов можно проанализировать командой ping -t <имя_сервера, например ya.ru>.
* '''Надежность дата-центра''' Теоретически — в дата-центре обеспечивается резервирование и электропитания, и каналов передачи данных. Естественно, в них стоят и промышленные климатические системы, поддерживающие заданную рабочую температуру всего оборудования. Но на практике часто бывает, что сервер оказывается недоступным на время от нескольких минут до нескольких дней. Техподдержка (если ее телефон вообще отвечает, а часто как раз в эти моменты она не работает — либо потому, что телефония работает на том же канале, который у них и «упал», либо потому, что тысячи пользователей серверов, обнаружив неполадки, начали им одновременно звонить) скажет «да, в вашем сегменте технические неполадки, мы устраняем», и больше сделать вы ничего не сможете. В случае, если сервер стоит у вас в офисе — вы сами принимаете моментальные меры. Вплоть до того, что можно вынуть из сгоревшего сервера жесткий диск, подключить к другому компьютеру, и восстановить работу системы.
* '''Стоимость''' При размещении на linux-VDS серверах стоимость на текущий момент — [http://firstvds.ru/products/vds_vps_hosting 600-900 руб/мес], Windows — [https://masterhost.ru/service/hosting/vps/ 4000 руб/мес]. По поводу выбора ОС читайте соответствующий раздел этой же статьи.

Отсюда вывод:
Мы рекомендуем устанавливать сервер «в облаке» только в случае сильно распределенной структуры компании. Когда максимальную скорость и надежность нужно обеспечить множеству удаленных пользователей, а не в одном конкретном месте.

== Доступ для установки системы ==

Для установки системы программисту MeaSoft требуется доступ к вашему серверу с правами администратора. В процессе установки потребуется устанавливать службы, запускать и останавливать их, а также производить запуск приложений от имени администратора. Доступ можно предоставить одним из способов:
* по [https://remontka.pro/microsoft-remote-desktop/ RDP] — передайте нам IP-адрес сервера, порт (если он отличается от стандартного), логин и пароль для подключения;
* через [https://www.teamviewer.com/ru/info/remote-desktop/ TeamViewer] — установите и запустите программу на сервере и передайте нам ID и пароль подключения.

== Рекомендованное периферийное оборудование ==

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

Мы рекомендуем:
* Zebex Z-3000 (CCD-сканер) — дешевый;
* Honeywell (Metrologic) 5145 Eclipse — лазерный;
* Honeywell (Metrologic) DS6707 — image, позволяет сканировать 2D-штрихкоды;
* Honeywell (Metrologic) 1202g Voyager BT — радиосканер, позволяет сканировать на расстоянии от компьютера.

Рекомендуются к приобретению сканеры с типом подключения USB HID.

Вы можете скачать наше бесплатное мобильное приложение [[Кладовщик — мобильное приложение для Android|Кладовщик]], которое работает как сканер штрихкодов.

Если вы определились с моделью сканера, то тип подключения не играет существенной роли: наша программа позволяет работать с любой из списка поддерживаемых моделей (проводной или беспроводной). Выбор интерфейса, скорее всего, зависит от наличия и доступности соответствующего порта на компьютере пользователя (так, интерфейс RS-232 предполагает наличие COM-порта, а интерфейс KBW, как правило, PS/2). Очевидным является тот факт, что наиболее универсальным будет сканер, работающий через интерфейс USB (USB HID).

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

При выборе сканера обратите внимание на то, что при типе подключения USB HID (рекомендуется) или «разрыв клавиатуры» сканер требует некоторой настройки. [[#Подключение и настройка сканеров штрихкодов|В разделе ниже]] приведены программирующие листы для различных моделей сканеров. Если вы покупаете сканер не из списка, для которого есть программирующий лист, будьте готовы к тому, что потребуется создание такого листа. Для его создания нужно полное руководство по программированию конкретного сканера на русском или английском языках. С этим часто бывают проблемы, если вы покупаете сканеры с доставкой из Китая — они, как правило, настолько китайские, что у них нет ни документации, ни сайта производителя. В таком случае остается уповать только на везение.

=== Термопринтер ===
Поддерживаются любые термо- и термо-трансферные принтеры. 
Рекомендуется термопринтер Zebra ZD410 — у него ширина печатающей головки 60 мм, поэтому ленту такой же ширины сложно вставить неправильно. Очень прост в обслуживании и заправке ленты. 
'''ВНИМАНИЕ!''' При покупке следует учитывать, что термопринтеры не комплектуются USB-шнуром и этикетками, поэтому их необходимо приобрести отдельно. Рекомендуем этикетки размером 58×40 мм.

=== Весы ===
Поддерживаемые весы:
* [[#Настройка весов МЕРА|МЕРА]] — подходят модели, которые поддерживают протоколы «ОКА», «9 байт» или «Mera Avto». По нашим сведениям, протоколы ОКА и Mera Avto поддерживают весы, у которых есть цифровая клавиатура 0-9. Но лучше уточняйте у продавца. Протокол «9 байт» в силу своей низкоуровневой работы с COM-портом может не работать через USB-переходники. Рекомендуем весы Мера ВП-3/30 — небольшие, точные, недорогие. 
* [[#Настройка весов НЕВА|Нева]]
* ExpressCube
* Масса-К
* InSize
* Мастер-Кит
* CAS HD 57583
* UIS Metrix

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

Инструкцию по настройке и подключению весов смотрите в этой статье [[#Настройка весов|ниже]].

=== Фискальный регистратор ===
В рамках 54-ФЗ поддерживается и рекомендуется работа с сервисом удаленной фискализации LIFE PAY.

Поддерживаются все фискальные регистраторы фирмы «Штрих-М»

Рекомендуется ШТРИХ-LIGHT-ФР-К (cамый бюджетный)

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

=== Банковский POS-терминал ===
[https://ru.wikipedia.org/wiki/POS-%D1%82%D0%B5%D1%80%D0%BC%D0%B8%D0%BD%D0%B0%D0%BB POS-терминал].
Мобильное приложение поддерживает интеграцию с сервисами IBox, LIFE PAY, а также поддерживается работа с независимыми POS-терминалами.

=== Планшетный сканер ===
Применяется для сканирования ведомостей с подписью, после чего полученные документы вы можете прикрепить в программе к соответствующей корреспонденции. 
Рекомендуются сканеры с автоматической подачей. 
При выборе устройства обратите внимание на следующие характеристики:
* Скорость сканирования;
* Наличие функции обнаружения подачи двух листов;
* Двухстороннее сканирование;
* Количество сканирований до отказа.

=== Монитор ноутбука/нетбука/компьютера ===
Рабочее место пользователя для работы с MeaSoft должно оснащаться монитором с разрешающей способностью экрана не менее 1024*768 пикселей. При работе на портативных устройствах, таких как нетбуки, у которых разрешение ниже рекомендуемого, в экран могут не помещаться некоторые окна.

=== Штрихкодовая линейка-угол ===
Штрихкодовая линейка-угол применяется для обмера габаритов отправления. Обмер можно производить при приеме корреспонденции на склад (F10 на вкладке «Заказы»). Каждое деление (1, 5 или 10 миллиметров) линейки промаркировано своим штрихкодом. Прикладывая товар к линейке и сканируя штрихкод, соответствующий краю товара, получаем размеры. Чтобы включить поддержку штрихкодированной линейки, нужно в окне приема, нажать кнопку «Настройки» и установить галку «Включить поддержку штрихкодированной линейки». Для работы с линейкой удобнее использовать лазерные сканеры, у них полоса считывания наводится точно на нужный штрихкод. Реализована поддержка производителя [http://cortes.ru/shtrihcode/barcodeline.php Кортес]. Перед покупкой нужно проверять модель на совместимость с системой. Система поддерживает следующий формат ШК: 
Длина ШК 7 символов, начинается всегда на «29», например: 291XXXX, 292XXXX, 293XXXX 
где: XXXX — значение в милиметрах, 3-й знак — направление измерения от 1 до 3, то есть координата (длина, ширина, высота).

=== Терминал сбора данных ===
Терминал сбора данных (ТСД) под управлением Android может работать совместно с MeaSoft как сканер штрихкодов или ТСД. Для этого установите на ТСД наше приложение [[Мобильное приложение кладовщика для Android|Кладовщик]] и выберите нужный режим работы.

== Подключение и настройка сканеров штрихкодов ==
MeaSoft поддерживает все виды [http://ru.wikipedia.org/wiki/Сканер_штрихкода сканеров штрихкодов], поэтому при выборе сканера следует учитывать особенности штрихкодов, которыми заказчики маркируют корреспонденцию. В частности, контактные светодиодные сканеры можно использовать для считывания штрихкодов длиной не более 5-7 см (в зависимости от модели сканера), а для двухмерных штрихкодов необходим image-сканер.

При подключении в разрыв клавиатуры или в порт USB в режиме эмуляции разрыва клавиатуры требуется небольшая дополнительная настройка сканера. Для этого существуют специальные программирующие листы (см. ниже) для разных моделей сканеров, на которых напечатаны штрихкоды в определенной последовательности. Просканируйте их в том порядке, в котором они расположены на листе. Как правило, для сканеров одной фирмы подходят одни и те же штрихкоды.
В результате этих действий при каждом сканировании перед штрихкодом вставляется определенный префикс, наличие которого для программы является признаком того, что данная последовательность символов введена с помощью сканера. Для использования в качестве префикса в программе зарезервирована клавиша с буквой «ё», что накладывает некоторое ограничение: невозможно ввести с клавиатуры символы «ё», «Ё», «`», «~».

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

{| class="wikitable" style="width: 60%
!style="width: 30%;"|Бренд
!style="width: 70%;"|Модель
|-
|Argox
|[https://www.courierexe.ru/download/scaner/Argox.doc ArgoScan 8000/8110/8120/8150/8250/8310/8312, argox as-8020cl (usb))]
|-
|Champtek
|[https://www.courierexe.ru/download/scaner/Champtek.doc Champtek]
|-
|Cino
|[https://www.courierexe.ru/download/scaner/Cino.doc F680BT]
|-
|Cipherlab
|[https://www.courierexe.ru/download/scaner/Cipherlab_1021_(simple).doc 1021 (simple)] [https://www.courierexe.ru/download/scaner/Cipherlab_1021_(simple)_and_back.doc 1021 с переключением обратно] [https://www.courierexe.ru/download/scaner/Cipherlab_1560,_1562,_1070_(bluetooth).doc 1560, 1562, 1070 (bluetooth)]
|-
|Metrologic/Eclipse/Honeywell/Motorola/Symbol/Youjie
|[https://www.courierexe.ru/download/scaner/Honeywell_Xenon_1900.doc Xenon 1900, Voyager 1202g, YJ4600] [https://www.courierexe.ru/download/scaner/Metrologic,_Eclipse,_Honeywell,_ms9520,_ms9540.doc MS5145, MS9520, MS9540, HH440] [https://www.courierexe.ru/download/scaner/Symbol_ls1203,_LS2208.doc LS1203, LS2208] (подходит для li4278, Zebra DS2278) [https://www.courierexe.ru/download/scaner/Symbol_ds6707.doc DS6707] [https://www.courierexe.ru/download/scaner/honeywell_1452g.docx Honeywell Voyager 1452G] [https://www.courierexe.ru/download/scaner/honeywell_1472g.docx Honeywell 1472g]
|-
|PayTor
|[https://www.courierexe.ru/download/scaner/Paytor%20DS%201009.docx DS 1009]
|-
|Proton
|[https://www.courierexe.ru/download/scaner/Proton.doc Proton]
[https://www.courierexe.ru/download/scaner/Proton_2.doc IMS3190, беспроводной)]
|-
|Datalogic
|[https://www.courierexe.ru/download/scaner/PSC,_Datalogic_QS2500.doc PSC, Datalogic QS2500] [https://www.courierexe.ru/download/scaner/qd2100.doc QD2100] 
[https://www.courierexe.ru/download/scaner/datalogic800i.docx Magellan 800i] 
[https://www.courierexe.ru/download/scaner/QuickScanMobile.doc Mobile: QM2100, M2]
|-
|Scanport
|[https://www.courierexe.ru/download/scaner/Scanport_T600.bmp T600]
|-
|Zebex
|[https://www.courierexe.ru/download/scaner/Zebex_4.bmp Zebex]
|-
|Godex
|[https://www.courierexe.ru/download/scaner/godex.doc GS550U]
|-
|Mercury
|[https://www.courierexe.ru/download/scaner/mercury.doc CL-200] [https://www.courierexe.ru/download/scaner/Mercury_1100PL.docx 1100PL]
|-
|Если у вас китайский безымянный (беспроводной?) сканер, попробуйте этот лист
|[https://www.courierexe.ru/download/scaner/Vioteh.doc Vioteh VT2208R, Dudian CT980N, bp8150s, Heroje B120G]
|-
|Vioteh
|[https://www.courierexe.ru/download/scaner/VT2205_VT2209.docx VT2205 VT2209]
|-
|Heroje
|[https://www.courierexe.ru/download/scaner/Heroje_H018.doc H018]
|-
|Производитель Китай под российским брендом АТОЛ. 
Cканер не рекомендуется к покупке. Атол выпускает несколько разных версий сканера под одной моделью SB1101. К сожалению, не все модели поддаются настройке.
|[https://www.courierexe.ru/download/scaner/Atol_SB_1101.docx SB 1101] [https://www.courierexe.ru/download/scaner/Atol_SB_1103.docx 1103]
|-
|Radall
|[https://www.courierexe.ru/download/scaner/Radall_RD-h8_2d.docx RD-h8 2d]
|-
|NETUM
|[https://www.courierexe.ru/download/scaner/NETUM_W6.docx W6, C750]
|-
|DBS
|[https://www.courierexe.ru/download/scaner/DBS_HC-3208SR.docx HC-3208SR (Подходите также к МSC-3208 WEC2D V.2)]
|-
|Winson
|[https://www.courierexe.ru/download/scaner/Winson_WNL_WNC_6003_6083.docx WNL/WNC 6003, 6083, 5083]
|-
|Global-pos
|[https://www.courierexe.ru/download/scaner/GP-9400B.docx Global-pos GP-9400B]
|-
|Mertech
|[https://courierexe.ru/download/scaner/Mertech_cl-2300.docx CL-2300]
|-
|Space
|[https://www.courierexe.ru/download/scaner/Space_x-2020rc.docx]
|-
|Bluetooth-кольцо
|[https://courierexe.ru/download/scaner/GP-1901B.docx GP-1901B]
|-
|Mindeo
|[https://www.courierexe.ru/download/scaner/mindeo_md6600.docx MD6600]
[https://www.courierexe.ru/download/scaner/Mindeo_cs2290_hd_bt.docx CS2290HD(BT)]
|-
|Holyhah a30d, Hstem a30d
|[https://courierexe.ru/download/scaner/holyhah_a30d_hstem_a30d.docx a30d]
|-
|Urovo R70 (71) сканер-кольцо
|[https://www.courierexe.ru/download/scaner/R70-71.docx R70(71)]
|-
|DATAMAX A-7710 B
|[https://www.courierexe.ru/download/scaner/DATAMAX_A-7710_B.docx A-7710 B] (если штрих-коды с листа плохо читаются, отсканируйте их же с приложенной к сканеру инструкции)
|}


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

'''Примечание 2'''. В некоторых моделях сканеров, особенно это касается DATAMAX, по умолчанию устанавливается неверная кодировка символов. Даже если вы правильно настроите сканер (установите префикс в виде знака тильды), при сканировании, на выходе такой сканер может отдавать совсем другой префикс (например, вместо ~ или Ё, будет /). Чтобы решить эту проблему, измените в настройках сканера местоположение или язык на English (или любой другой, где доступно ASC2 code keyboard input) путем считывания специального управляющего кода из инструкции к сканеру.

Cписок '''неподдерживаемого системой оборудования''':
* CT10 Barcode Scanner (Производитель CILICO Electronics Co., Ltd Китай);
* Аlanda 2.4G Barcode Scanner (производитель Китай).
* Birch bd — 388 iiib (производитель Китай);

Это оборудование не позволяет установить требуемый префикс для работы с MeaSoft. Список далеко не полный.

'''Мы рекомендуем покупать сканеры, официально ввезенные в Россию, адаптированные для российского рынка, имеющие здесь официальных поставщиков.'''

При выборе сканера обратите внимание на то, что при типе подключения USB HID (этот режим рекомендуется) или «разрыв клавиатуры» сканер требует некоторой настройки. В разделе описания выше приведены программирующие листы для различных моделей сканеров. Если вы покупаете сканер не из списка, для которого уже есть программирующий лист, будьте готовы к тому, что потребуется создание такого листа. Для его создания нужно полное руководство по программированию конкретного сканера на русском или английском языках. С наличием инструкции очень часто возникают проблемы, если вы покупаете сканеры с доставкой из Китая — они, как правило, настолько не адаптированы к работе, что у них нет ни документации, ни сайта производителя. В таком случае остается уповать только на везение.

Если ваш новый сканер не поддерживается нашей системой, можно попытаться выяснить, может ли он работать в режиме эмуляции COM-порта. Наличие возможности работы в таком режиме — последний шанс использовать купленное оборудование:
# Переведите сканер в режим USB virtual COM по инструкции.
# Установите бесплатные драйверы COM-порта Nuvoton.
# В MeaSoft программе выберите '''Настройка''' > '''Параметры''' > '''Оборудование''' > '''Использовать COM-сканер''', укажите номер виртуального COM-порта, созданного драйвером (см. в диспетчере устройств Windows).
Обратите внимание, что при переключении сканера в другой USB-порт может меняться номер COM-порта, и настройку программы нужно делать заново.

===Возможные проблемы при работе сканеров с маркировкой Честный Знак===

В некоторых сканерах по умолчанию может быть включена настройка, которая пытается компенсировать работу CapsLock, если тот включен, чтобы, например, в блокнот всегда печатался одинаковый код. Наша программа не учитывает CapsLock при сканировании и берет только те значения, которые передает сканер. Поэтому, при нажатом CapsLock может предаваться код маркировки с измененными регистрами букв, что затем будет мешать в работе с маркировкой. Чтобы этого избежать, нужно отключить опцию, компенсирующую работу CapsLock. Например, для сканера Sunlux XL-3200 данная настройка называется '''Caps Lock Off''': [[Файл:CapsOnScanner.png|none|700px]]

== Настройка весов ==

=== Общие сведения ===
MeaSoft поддерживает работу с различными видами весов. Весы могут подключаться через сетевой порт, COM- или USB-порт.

При подключении через USB установите на компьютер драйвер USB-COM конвертера. Драйвер поставляется производителем весов либо переходника, через который вы подключаете весы. После установки драйвера в «Диспетчере устройств» вашего компьютера должен появиться новый COM-порт, через который и будет осуществляться дальнейшее взаимодействие с весами. Обратите внимание: при подключении USB-шнура к другому USB-разъему компьютера может измениться номер COM-порта, который привязан к шнуру. В этом случае укажите в программе новый номер порта.

Чтобы начать использовать весы, подключите их к компьютеру, затем в пункте основного меню '''Настройка > '''Параметры''' > '''[[Настройка параметров рабочего места#Оборудование|Оборудование]]''' установите флажок '''Использовать весы''', выберите тип весов и укажите порт.

После успешного подключения весов откройте карточку корреспонденции (или окно «Прием» в заказах). Возле поля '''Масса''' появится кнопка весов. Чтобы программа показывала вес с весов, эта кнопка должна быть нажата.

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

=== Настройка весов МЕРА ===
Для связи с весами мера система использует протоколы «9байт», «ОКА» и «MERA-AUTO» и «Сетевые».

Какой выбрать:
* 9байт — установлен в весах по умолчанию. Он позволяет передавать нестабильный вес, что хорошо влияет на скорость работы оператора. Однако это протокол использует низкоуровневую работу с COM-портом, что может не поддерживаться USB-COM переходниками. Выбирайте этот протокол если весы подключены к настоящему, аппаратному COM-порту. Так же этот протокол, вероятно, единственный, который можно использовать в весах, у которых нет цифровой клавиатуры (см. ниже — без нее весы просто невозможно переключить на другой протокол);
* ОКА — во многих моделях весов не поддерживает передачу нестабильного веса, так что работать с ним — медленнее, чем возможно. Но этот протокол поддерживают все весы «МЕРА» с цифровой клавиатурой;
* MERA-AUTO — наиболее продвинутый, рекомендованный производителем протокол. Позволяет передавать нестабильный вес. Однако весы нужно на него переключать (см. ниже), также он поддерживается не всеми весами;
* Сетевые — для весов, подключающихся не к COM-порту, а непосредственно к локальной сети.

Выбор протокола в весах: воспользуйтесь выдержкой из их [http://courierexe.ru/download/scale/mera/MERA-VTP_VT-1A_2007.pdf руководства пользователя] или [http://courierexe.ru/download/scale/mera/servmanpvm2007.pdf другой версии руководства]:

9.1 Выбор протокола
9.1.1 Удерживая нажатой кнопку «5» клавиатуры терминала, кратковременным нажатием кнопки «[[Файл:PowerOn.png]]» включить весы.
Используя ту же клавиатуру набрать код 39654 и затем нажать клавишу ввода «[[Файл:Enter.png]]» или «T» (Тара).
При правильно выполненном действии будет активизирован режим настройки и на дисплее появится сообщение «_____9».
9.1.2 Последовательно нажать кнопки «1» и «4» и ввести кодовый номер требуемого протокола '' '''(для протокола "9байт" - «0», "ОКА" - «1», "MERA-AUTO" - «5»)''' '' из таблицы кодов нажатием одной из кнопок «0»…«9».
9.1.3 Нажатием кнопки «9» зафиксировать результат.

'''Обратите внимание''' на то, что в этой инструкции подразумевается наличие полной цифровой клавиатуры с кнопками «0».."9". Если у ваших весов такой клавиатуры нет — они не поддерживают изменение протокола, и переключить их не удастся.

В программе нажмите «Настройка» — «Параметры» — «Оборудование». Поставьте галку «Использовать весы», выберите протокол и порт весов. После настройки обязательно перезагрузите программу и весы.

Для проверки работоспособности подключения можно использовать официальную [http://courierexe.ru/download/scale/mera/Oka.exe программу МЕРА]. Обратите внимание, что эта программа не будет работать, если открыта программа MeaSoft с включенным использованием весов, и наоборот. В один момент времени к весам может подключаться только одна программа.

=== Настройка весов НЕВА ===
По нашему опыту работы с весами «НЕВА» складывается интересная ситуация: производитель заявляет, что все модели их весов работают по разным протоколам. Протокол зависит от модели «пульта» — такой штуки, с индикатором и кнопками. При этом по конкретной модели пульта они передали протокол, который не соответствует действительности. В итоге конкретные весы, имевшиеся в наличии, к программе подключены (методом [https://ru.wikipedia.org/wiki/Обратная_разработка обратного инжиниринга] протокола), в списке видов весов в настройке оборудования они присутствуют, но мы не можем дать никаких гарантий того, что конкретные весы, приобретенные вами, будут работать с программой. Мы не рекомендуем этот тип весов к приобретению, но если они у вас уже есть и система с ними не работает — звоните, будем думать, что с этим можно сделать.

=== Настройка весов МАССА-К ===
Для поддержки весов Масса-К в системе предусмотрена поддержка «Протокола № 2». Этот протокол по умолчанию включен в весовых терминалах [https://courierexe.ru/download/scale/massa/TB_A_r6.2_2017.pdf А/ТВ] и [https://courierexe.ru/download/scale/massa/TB_T_r3.2_2016.pdf Т/ТВ]

=== Настройка весов CAS ===

В программе поддерживаются весы CAS с протоколом AD. Известно, что протокол AD используется во всех моделях линейки HD, DB, но у него есть несколько версий. Чтобы весы начали передавать вес в программу, необходимо в настройках весов, через специальное меню настроек (описание есть в документации к весам), включить режим автоматической передачи данных по стабилизации.

Примеры настройки:
*Для весов CAS DB-1H в программе выберите ротокол '''CAS DB-H'''. В настройках весов обязательно включите режим '''Pr off'''. Скорость передачи 9600;
*Для весов CAS HD (300, 4050) в программе выберите протокол '''CAS HD''';

=== Настройка весов Mettler Toledo ===

Для поддержки весов TLX Mettler Toledo в программу добавлен протокол TLX Mettler Toledo (TCP/IP Client), весы настроены в качестве сервера, программа подключается к весам и обрабатывает сообщения с данными измерений. Поддерживается передача: штрих-кода, веса, длины , ширины, высоты.

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

Настройка порядка цены деления весов доступна через главное меню '''Настройка''' > '''Параметры''' > '''Оборудование''', поле '''Порядок цены деления'''.

Доступные значения поля '''Порядок цены деления''':

'''0''' — 1 грамм;

'''1''' — 10 грамм;

'''2''' — 100 грамм.

Таким образом, если весы показывают в 10 раз меньше, чем на самом деле, установите '''Порядок цены деления''' равным 1.

== Настройка фискальных регистраторов ==
Все фискальные регистраторы должны вноситься в справочник '''[[Фирмы]]'''. Для корректной работы ФР необходимо регистрировать ее в налоговой с нужным признаком агента, а потом прописывать его в системе.

=== Стационарные Штрих-М ===

=== Облачные LIFE PAY ===

=== Облачные Webkassa ===

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

Закрытие смены происходит через ЛК WebKassa

== Мобильные устройства курьеров ==
Процесс выбора оборудования, установки и настройки приложения для мобильного устройства курьера подробно рассмотрен в статьях «[[Мобильное приложение курьера для Android]]» и «[[Мобильное приложение курьера для IPhone]]».

Руководство программиста

2026-01-15T15:29:52Z

Sammy: /* Недавние изменения */

== Основные положения ==

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

Как интерпретатор приводит типы:

1. При использовании значения как параметр функции интерпретатор автоматически приводит значение к типу, необходимому функции.

2. При операциях сложения, а также логических операциях, операнды приводятся к строке если хотя бы один из них имеет тип «строка». Например:
3.3+5 -> 8.3
‘3.3’+5 -> ‘3.35’
подобную проблему можно решить принудительно преобразовав тип:
float(‘3.3’)+5 -> 8.3

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

Как работают функции приведения типов:

1. При преобразовании строки к числу: функция «читает» строку до первого символа, не позволяющего создать число с плавающей точкой, при этом разделителем целой и дробной частей может быть как точка так и запятая. Если приведение производится к целочисленному типу, то после этого происходит округление. Например:
float('3.6qwerty735') -> 3.6
int('3.6qwerty735') -> 4

2. При преобразовании к булевому типу ложью считается пустая строка либо число 0, все остальное - истина

3. При преобразовании булевого типа к числу истина преобразуется в 1, ложь – в 0. Такое преобразование позволяет использовать сложение и умножение в качестве логических «ИЛИ» и «И» соответственно:
if((5=5)+(6=7), <a>, [b]) – условие истинно, выполнится код «a».

4. При преобразовании булевого типа к строке сначала происходит преобразование к числу:
(5=5)+'qwerty' -> ‘1qwerty’

== Описание синтаксиса ==

Команды разделяются точкой с запятой. Параметры функций разделяются запятыми. Каждая команда (даже цикл while) является функцией, возвращающей некоторое значение. Результатом выполнения составной команды (последовательности функций, разделенных точкой с запятой), является результат выполнения последней функции. Имена переменных, функций, объектов, а также их свойств и методов не чувствительны к регистру.
Константы: константы бывают целочисленными, дробными и строковыми. Значения целочисленных и дробных констант указываются «как есть» (в этом случае разделитель целой и дробной частей – точка), шестнадцатеричные значения начинаются с символа «$» и, если первая цифра – буква, она упреждается цифрой 0, а строковые – в одинарных кавычках. При этом, если внутри строковой константы встречается символ одинарной кавычки он должен быть задвоен, для указания интерпретатору того, что он не является признаком конца константы.
Операции сравнения: >, <, =, ! - Больше, меньше, равно, не равно соответственно.
Логические операции: + (ИЛИ), * (И).
Арифметические операции: +, -, *, /
Операция конкатенации строк: +

=== Функциональность базового объекта ===

'''SET($a, a)''' – присваивает переменной (1-й параметр) значение второго параметра. При отсутствии переменной – создает ее. Имена переменных должны начинаться с символа «$», а следующий символ не должен быть цифрой. Возвращает новое значение переменной. Функция используется только для задания значений переменных. Не допускается использования для задания значений свойств объектов. Для этого используются соответствующие методы этих объектов.

'''IF(a,b,c)''' или '''IF(a,b)''' – Условный оператор. В первом случае возвращает b, если a истинно (не равно нулю или пустой строке), иначе – c. Во втором случае – возвращает a, если оно истинно, иначе – b.

'''WHILE(a, b)''' – Оператор цикла. Выполняет b пока a истинно:
set($i, 10);
set($sum, 0);
while($i>0, set($sum, $sum+$i); set($i, $i-1));
$sum
Результат – 55

'''FOR($a, b, c, d)''' – Оператор цикла. Выполняет d пока $a последовательно присваиваются значения от b до с включительно:
set($sum, 0);
for($i, 1, 10, set($sum, $sum+$i));
$sum
Результат – 55

'''NEW(ClassName, InstanceName)''' – Создает экземпляр класса ClassName, назначает ему имя InstanceName. Возвращает порядковый номер созданного объекта. Доступ к свойствам и методам объектов осуществляется по имени объекта и имени свойства/метода, разделенным точкой. Именем объекта может быть и пустая строка, тогда доступ к его свойствам и методам будет осуществляться без указания имени, и, в случае совпадения имен свойств и/или методов со стандартными или свойствами/методами других объектов, использоваться будут соответствующие свойства/методы объекта, созданного ранее, а также такой объект невозможно уничтожить до окончания выполнения скрипта. Все объекты созданные во время выполнения скрипта уничтожаются автоматически после окончания его выполнения.

'''FREE(InstanceName)''' – Уничтожает объект с именем InstanceName. Возвращает 0. В случае отсутствия объекта с заданным именем вызывает ошибку.

'''ShowObjects''' – Возвращает список созданных объектов – названия классов и имена.

'''ERROR(message)''' – Вызывает ошибку с текстом message.

'''SHOWMESSAGE(message)''' – Отображает диалоговое окно с текстом message, останавливает выполнение скрипта до закрытия окна пользователем.

'''SimpleAskUser(Message)''' – Выводит диалоговое окно с текстом Message и кнопками «Да» и «Нет». Возвращает 1, если пользователь нажал кнопку «Да», иначе – 0.

'''TRY(a)''' – Выполняет a в «защищенном от ошибки» режиме. Если в процессе выполнения a возникает ошибка, возвращает текст ошибки, иначе – 0 (ложь).

'''REM(….)''' – Код в скобках игнорируется (комментарий).

'''EXEC(FileName, Params, Wait, WindowState)''' – Запускает внешнее приложение FileName с параметрами Params. Если Wait истинно – ожидает завершение процесса. Для WindowState доступны следующие числовые значения:
0 - SW_HIDE
1 - SW_SHOWNORMAL (по-умолчанию)
3 - SW_MAXIMIZE
6 - SW_MINIMIZE
Функция возвращает истину если приложение запущено успешно. Иначе – Ложь.
В случае успеха, при параметре Wait – истина кладет в переменную $LastResult код завершения приложения.

'''CASE''' - Оператор множественного выбора. Позволяет выполнить одно из нескольких действий в зависимости от условий. Синтаксис:
<source>
case(
when(условие1, действие1);
when(условие2, действие2);
...
else(действие_по_умолчанию);
);
</source>

Пример использования:
<source>

set($a, 10);
set($b, 50);

showmessage(
case(
when($a < 5, 50);
when($a < 10, 100);
when($a < 250, 200);
else($a*$b);
)
);
</source>

'''AttachDebugger''' - Команда позволяет подключить открытый [[Отладчик_встроенных_скриптов]] к текущему скрипту. Команда AttachDebugger должна быть '''первой командой''' в скрипте. Добавьте её в самое начало скрипта:

<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Как работает:'''
# При выполнении команды AttachDebugger скрипт останавливается.
# Отладчик автоматически подключается к выполняющемуся скрипту.
# Текст скрипта загружается в редактор отладчика.
# Можно ставить точки останова, просматривать переменные и продолжать отладку.

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Если режим отслеживания не включён, команда `AttachDebugger` игнорируется.
* В режиме отслеживания может работать только один отладчик.
* Команда AttachDebugger должна быть первой командой в скрипте.

=== Строковые функции ===

'''UpCase(s)''' – возвращает строку s в верхнем регистре.

'''LCase(s)''' – возвращает строку s в нижнем регистре.

'''Len(s)''' – возвращает количество символов в строке s.

'''Pos(s, substr [,start])''' – возвращает номер первого символа первого включения подстроки substr в строку s, возвращает 0, если включения подстроки отсутствуют. Параметр start - это позиция старта поиска, не обязательный параметр, по умолчанию равен 1. Поиск не чувствителен к регистру.

'''Param(s, i)''' – возвращает i-й элемент строки s, разделенной запятыми на элементы.

'''ParamsCount(s)''' - возвращает количество элементов строки s, разделенной запятыми на элементы.

'''SetParam(s, p, i)''' – заменяет на значение p i-й элемент строки s, разделенной запятыми на элементы.

'''Left(s, i [,full] )''' – возвращает i первых символов строки s. Параметр i, может быть строкой, тогда он считается разделителем и функция, возвращает строку слева от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Mid(s, i, j)''' - возвращает подстроку из s начиная с i символа и длиной j символов

'''Right(s, i [,full])''' – возвращает i последних символов строки s. Параметр i, может быть строкой, тогда он считается разделителем, функция ищет разделитель с конца строки, и возвращает строку справа от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Reverse(s)''' - возвращает строку s задом-наперед. Полезно например для поиска с конца функций Pos().

'''Char(i)''' – возвращает символ с кодом i.

'''Ord(s)''' – возвращает код первого символа строки s.

'''Replace(s, strFind1, strReplace1, [ strFind2, strReplace2, ... ], [caseInsensetive])''' - возвращает строку s, в которой все включения строк strFind заменены строкой strReplace. Параметры поиска и замены всегда должны быть в паре и их может быть несколько. caseInsensetive - неучитывать регистр, не обязательный параметр, по умолчанию включен.

'''RemSpace(s)''' – возвращает сроку s без начальных и конечных запятых и пробелов, а также начальных точек.

'''SumStr(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''с добавлением валюты'''. Необязательные параметры captions - позволяет изменить название валюты, формат строки может зависеть от текущего языка(посмотреть формат можно в "Справочники"-"Статусы"-"32 Валюты", в разделе "Дополнительная информация"). Language - код языка на котором необходимо вывести сумму прописью. По умолчанию если не обязательные параметры опущены, используются региональные настройки в переменных.

'''NumToStrSimple(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''без валюты'''. Параметры идентичны функции SUMSTR.

'''FullNameToShort(Name)''' – Возвращает фамилию и инициалы по полному ФИО Name.

'''MonthName1(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в именительном падеже.

'''MonthName2(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в родительном падеже.

'''StrForXML(s)''' - Подготавливает строку к парсингу как xml: Если находит в строке подстроку "UTF-8" - перекодирует ее из utf-8 в win-1251, убирает начальный знак вопроса, если такой встречается.

'''FixedIntToStr(i, len[, char])''' - Возвращает целое число i дополненное слева символами char (по-умолчанию - "0") до длины len.

'''Translate(format, [param1, param2, ...])''' - Функция перевода строки format в язык пользователя. Строка format может содержать параметры %s, %d - строка и число соответственно.

'''ExtractFileName(FilePath)''' - возвращает имя файла с расширением из полного пути к файлу FilePath.

====Функции перекодировки====
'''DecodeStr(s, charset)''' - Производит перекодировку строки s в кодировку CP1251. Кодировка строки s должна быть заранее известна и может быть :
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866, UNICODE. Имя кодировки следует передавать в точности без лишних символов.

'''EncodeStr(s, charset)''' - Производит перекодировку строки s в кодировку charset. Кодировка строки s должна быть CP1251, возможны следующие варианты перекодировки:
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Имя кодировки следует передавать в точности без лишних символов. UNICODE не работает с версии 2021, в ней строки по умолчанию в кодировке unicode.

Функции EncodeBase64(s), DecodeBase64(s), UrlEncode(s), UTF8Encode(s), UTF8Decode(s), Str2UTF(s) - устарели, используйте EncodeStr, DecodeStr.

====Транслитерация====

'''Translit(s)''' - транслитерация строки русского текста s латиницей

'''UnTranslit(s)''' - транслитерация строки s с латиницы на русский.

==== Экранирование ====

'''QUOTEDSTR(s)''' – квотирует строку s символом «\» (обратный слеш). Возвращает строку s, помещенную между символами одинарной кавычки, при этом все вхождения в строку s символов: «\», «"» и «'» экранируются квотирующим символом, а символы #0, #10 и #13 заменяются на \0, \n и \r соответственно.

'''SQLFloat(f)''' – Приводит число с плавающей точкой к виду, пригодному для SQL-запроса, т.е. к тексту с разделителем дробной части – точка.

'''FormatTextXML(s)''' - квотирует строку s для использования в XML. Производит замены спец. символов для корректности XML-синтаксиса.

'''FormatTextJSON(s)''' - переводит строку в формат JSON, экранирует служебные символы.

'''FormatTextBlob(s)''' - строка s содержит файл, функция перекодирует переданную строку в байты, используется для заполнения полей формата blob.

====Хеширование ====

'''HMACHash256(key, text)''' - создаёт хэш по алгоритму SHA256 для проверки целостности сообщения, key - секретный ключ, text - хэшируемое сообщение

'''MD5Hash(text)''' - создаёт хеш по алгоритму MD5

'''SignatureUrl(url)''' - Подписывает переданный URL. Функция возвратит переданный URL с добавленным в конце параметром, в котором будет записана подпись.

=== Функции работы с датой и временем ===

'''CurrTime''' – возвращает текущее время

'''CurrDate''' – возвращает текущую дату

'''CurrMillisecond''' - Возвращает количество миллисекунд прошедших с начала текущего года. Используется для точного расчета временных интервалов.

'''Today''' - возвращает текущую дату в числовом формате.

'''Day(dt)''' – возвращает день месяца даты dt.

'''Month(dt)''' – возвращает месяц года даты dt.

'''Year(dt)''' – возвращает год даты dt.

'''FirstDayOfMonth(dt)''' – Возвращает первый день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( FirstDayOfMonth( CurrDate() ) );
'''Полужирное начертание'''
'''LastDayOfMonth(dt)''' – Возвращает последний день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( LastDayOfMonth( CurrDate() ) );

'''DaysInMonth(month, year)''' – Возвращает количество дней в указанном месяце.

'''IncDay(dt, [count=1])''' – Возвращает дату, увеличенную на count дней.

'''SQLDate(dt)''' – Пытается конвертировать dt в дату, вернуть в формате «'YYYY-MM-DD'» (с апострофами), если не удается – возвращает «NULL».

'''SQLDateToDate(dt)''' – Переводит дату из SQL-формата в обычный.

'''DAYSBETWEEN(dt1, dt2)''' – Возвращает количество дней между датами dt1 и dt2. В случае ошибки приведения dt1 или dt2 к дате возвращает -1000.

'''TimeBetween(t1, t2)''' - Возвращает количество минут между временем t1 и t2. Если t1 > t2 то будет показано количество минут между t2 и t1. Параметр t может быть как в формате "HH:MM", так и в числовом. Если один из параметров не удалось привести к числовому типу возвращает -1000.

'''WorkDaysBetween(dt1, dt2, [DecreaseFirstDay=0], [DefaultHolidayVarNum=1])''' - Возвращает количество рабочих дней между датами dt1 и dt2. Параметр DecreaseFirstDay уменьшает dt1 на указанное количество дней (по умолчанию 0). В случае ошибки приведения dt1 или dt2 к дате возвращает -1000. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней(по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''TimePeriod(time1, time2)''' - Оформляет временной период. Возвращаемое значение зависит от наличия значения в параметрах. Возможные варианты: "time1 - time2" , "С time1" , "ДО time2".

'''StrDateToFloat(s, [time=false])''' - Переводит строку с датой s в числовой тип. Если параметр time включен, то в строке s должно быть указано время. Дата должна быть в формате "DD.MM.YYYY", а время "HH:NN". Если строку перевести не удалось возвращает 0

'''IsAWorkDay(dt)''' - Когда день dt является рабочим, возвращает true. Если произошла ошибка приведения даты возвращает -1000.

'''IncWorkDay(dt, [count=1],[DefaultHolidayVarNum=1])''' - Прибавляет count рабочих дней к дате dt. Возвращает дату в числовом формате, если произошла ошибка приведения даты возвращает -1000. По умолчанию параметр count равен 1 и не является обязательным. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней (по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''Sleep'''(n) - Задержка выполнения на n миллисекунд.

=== Функции приведения типов ===

'''INT(v)''' – возвращает значение типа “целое”, приводя вариантное значение v к числовому типу, а затем округляя его. В том числе используется как функция округления.

'''FLOAT(v)''' – возвращает значение типа “число”, приводя вариантное значение v к числовому типу, переводя в число цепочку символов до первого нецифрового символа (либо точки или запятой).

'''STR(v)''' – возвращает значение типа “строка”, приводя вариантное значение v к строковому типу.

'''Date(v)''' – возвращает дату, либо пустую строку, если не удается конвертировать v в дату

'''Time(v)''' – возвращает время, либо пустую строку, если не удается конвертировать v во время. Понимает числовое представление времени.

=== Математические функции ===

'''ROUNDUP(f)''' – округляет число f до ближайшего большего по модулю целого числа.

'''ROUNDDN(f)''' – округляет число f до ближайшего меньшего по модулю целого числа.

'''Money(f, CouldBeEmpty, ZeroFill, MakeSpace)''' - Округляет число f, до двух знаков после запятой. CouldBeEmpty - заменить число меньше 0,0001 на пустую строку. ZeroFill - Следить чтобы после запятой было два знака, если будет один, то добавить ноль. MakeSpace - Разделить разряды пробелом.
''Подсказка: для простого округления используется функция int()''

'''Abs(f)''' - возвращает модуль числа f.

'''Mod(x, y)''' - возвращает остаток от деления целочисленного числа x на целочисленное число y.

=== Константы ===

'''Null''' – Возвращает пустое значение.

'''Да''', '''True''', '''Нет''', '''False''' – константы, соответствующие булевым значениям.

=== Прочие функции ===

SetPhoneParams(CountryCode, TownCode) – Устанавливает глобальные настройки кода телефонных кодов страны и города соответственно. По-умолчанию код страны – 7, код города – 495.

PhonesCount(s) – Возвращает количество корректных телефонных номеров, найденных в строке s.

GetPhone(s[, n]) – Возвращает n-й корректный телефонный номер, найденный в строке s. Нумерация начинается с 1.

GetEmail(s) – Возвращает все корректные адреса email, найденный в строке s, разделенные запятыми (т.е. готовыми к передаче в функцию SendEmail).

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

GenEan(ID, Code) – Формирует штрих-код EAN 13 Состоящий из идентификатора типа сущности ID и кода сущности Code, Выравнивает до 13-ти символов, первый – «2», последний – контрольная сума.

CheckEan(s) - Проверяет строку s, что она является кодом EAN13.

SaveToFile(FileName,s, encoding [, append])- Создает текстовый файл по пути, указанному в FileName (если по указанному пути существует файл с указанным именем, он удаляется и создается новый) и производит запись строки s в созданный текстовый файл. encoding - название кодировки, по умолчанию сохраняет в кодировке ANSI. Доступные названия кодировок: KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Если append = true, то производится дописывание данных в файл, а не перезаписывание (не обязательный, по умолчанию выключен).

StrFromFile(FileName) - Читает файл FileName, возвращает в виде строки. При ошибке чтения вызывает ошибку.

DownloadAttachment(code, [savefilepath, tablename='attachment', fieldBlob='file', fieldLDtime='ldtime', fieldUID='uid']) - Функция выкачивает аттачмент из базы, по внутреннему коду - Code, всегда возвращает содержимое файла в виде строки, а также может сохранить файл по указанному пути в параметре savefilepath. По умолчанию, функция настроена на таблицу attachment. Code - внутренний код вложения, tablename - название таблицы, fieldBlob - название поля с содержимым файла, fieldLDtime - название поля с временем последнего изменения строки (для работы кэша). Функция использует кэш и умеет выкачивать файлы зауженные на внешние серверы (http, ftp,sftp, measoft). Для выкачивания с сервера measoft обязательно необходимо указывать параметр fieldUID.

DeleteFile(FileName) - Удаляет файл FileName с диска, возвращает истину, если операция прошла успешно и ложь - в противном случае.

HTTPPOST(host, PostParams, Proxy, ContentType, HTTPUser, HTTPPass, Method, CustomHeader, Reconnects) - Отправляет HTTP запрос по адресу host с данными PostParams. Proxy - объект Proxy, задающий прокси-сервер (по-умолчанию - пусто - не использовать прокси). ContentType - Заголовок ContentType. По-умолчанию - "application/x-www-form-urlencoded; Charset=UTF-8". HTTPUser и HTTPPass - данные для http-авторизации на сервере. Method - метод отправки запроса, по-умолчанию - "POST". CustomHeader - Дополнительные заголовки HTTP запроса, передается в виде списка параметров через запятую и всегда образуют пару: 1 параметр - название заголовка, 2 параметр - значение. Если значение содержит запятую то его нужно экранировать в двойные кавычки. Reconnects - Количество попыток подключения (по-умолчанию - 2), если больше 100 - это таймаут единственной попытки подключения в миллисекундах.
Функция возвращает ответ сервера. 
''Обратите внимание:'' Для имитации отправки данных html-формы методом POST может понадобиться перед передаваемыми параметрами добавить "Data=".

FTPPUT(host, User, Pass, FileName[, Active]) - Отправляет файл на FTP/SFTP-сервер. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

FTPGET(host, User, Pass, SourceFileName, DestFileName[, Active]) - Загружает файл SourceFileName с FTP/SFTP-сервера, сохраняет его в файл DestFileName. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

GetTempDir - Возвращает путь к временной папке.

ApplicationDir - Возвращает путь к файлу программы.

Interpretate(script) - Интерпретирует скрипт указанный в script. Выполнение происходит в текущем инстансе.

LastHttpError - Выводит последний запрос выполненный с ошибкой в функции HttpPost. Содержит подробную информацию по запросу и ответу.

LastHttpResponse - Выводит последний запрос и ответ от сервера после выполнения Http-запроса в функции HttpPost.

== Объект TExcel ==

Предназначен для доступа к данным документов MS Excel. Требует установленного приложения MS Excel. Для работы без установленного MS Excel предусмотрен объект TDirectExcel.

'''''Ввод данных'''''

LoadFromDB(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Если Headered истинно (по-умолчанию), таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Если TranslateHeader истинно, то заголовки таблицы будут автоматически переведены.

MyDB.Open('select * from kurier');
xl.LoadFromDB(MyDB.Self);
xl.DoNotDestroy(true);
xl.SetVisible(true);

Post2Sheet(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) - Почти полный аналог LoadFromDB. В отличии от LoadFromDB если есть открытый файл, выгрузка данных будет выполнена прямо в него.

OpenFile(aFileName) – Выполняет функции SetFileName и Open.

FileName – Возвращает имя текущего файла.

SetFileName(aFileName) – Задает значение свойства FileName.

Open - Открывает файл с именем, заданным свойством FileName. Если имя файла не задано - создает чистую книгу.

Close – Закрывает текущий файл.

'''''Ячейки'''''

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

Cell(x, y, text) – Возвращает значение ячейки, заданной координатами x, y. Необязательный булевый параметр text, в случае истинности, указывает на необходимость возврата данных с учетом формата ячейки, т.е. то, что пользователь видит на экране. Обратите внимание, что если в ячейке число, и ширина столбца не достаточна для отображения, Excel выводит "#####", что и будет возвращено программе, если text=ИСТИНА. Поэтому перед таким использованием рекомендуется выполнить функцию AutoFit.

SetCell(x, y, v[, x2, y2]) – Устанавливает значение ячейки, заданной координатами x и y, в значение v. Если заданы параметры x2, y2 - объединяет (merge) диапазон ячеек заданных координатами, устанавливает значение объединенной ячейки.

'''''Строки'''''

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

RowAutoFit([y1, y2]) - Устанавливает автоматическую высоту строк. Аргументы y1 и y2 необязательны и если не указаны, то процедура будет выполнена для всей страницы, в ином случае только для строк от y1 до y2.

SetRowHeight(r, h[, cnt]) – Устанавливает высоту cnt строк (по-умолчанию 1) начиная со строки r в h пикселей.

GetRowHeight(r) – Возвращает высоту строки r в пикселях.

RowInsert(i[, count]) - Вставляет count (по-умолчанию - 1) строк НАД строкой с номером i.

RowDelete(i[, count]) - Удаляет count (по-умолчанию - 1) строк начиная с номера i.

'''''Столбцы'''''

ColCount - Возвращает количество столбцов в листе.

AutoFit – Устанавливает автоматическую ширину столбцов.

ColumnDelete(i[, count]) - Удаляет count (по-умолчанию - 1) столбцов начиная с номера i.

SetColWidth (c, w) – Устанавливает ширину столбца c в w пикселей.

GetColWidth (c) – Возвращает ширину столбца c в пикселях.

'''''Листы'''''

SetSheet(No) – Устанавливает номер текущего листа. Если лист с таким номером не существует - он будет создан (и все листы до него). Нумерация начинается с 1.

SetSheetName(Name) - Устанавливает название текущего листа.

SheetsCount – Возвращает количество листов в книге.

CopySheetAfter([SheetFrom[, SheetAfter]]) - Копирует лист SheetFrom (по-умолчанию - текущий), создавая новый лист после листа SheetAfter (по-умолчанию - совпадает с копируемым).

SheetDelete(i) - Удаляет лист с номером i.

'''''Форматирование'''''

Align(x1, y1, x2, y2 [,HAlign, VAlign]) - Устанавливает выравнивание данных в указанном диапазоне. HAlign - горизонтальное выравнивание (0 – прижато влево , 1 – по центру , 2 – прижато вправо), VAlign - Вертикальное выравнивание (0 – прижато к верху , 1 – по центру , 2 – прижато к низу).

WrapText(x1, y1, x2, y2, value) – Устанавливает перенос текста прямоугольника в значение value. Если координаты опущены, или 0 – устанавливает границы всей используемой области. Для Value значение по-умолчанию - true.

NumberFormat(x1, y1, x2, y2, Format) - Устанавливает формат вывода чисел в указанном диапазоне ячеек. Например, если Format='0.00' - числа будут выводиться c обязательными 2 знаками после десятичного разделителя.

SetBorders(x1, y1, x2, y2) – Устанавливает границы прямоугольника. Если координаты опущены, или 0 – устанавливает границы всей используемой области.

SetFont(Font[, x1, y1[, x2, y2]]) - Устанавливает шрифт Font для ячеек диапазона. Можно указать координаты только одной ячейки, можно - вообще не указать, тогда будет использован последний выделенный диапазон. Шрифт задается как обычно: 'Arial, 16, T, T, T', порядок параметров: Имя шрифта, размер, жирное начертание, курсивное начертание, одиночное подчеркивание. Если параметры не заданы, то у текущего шрифта они меняться не будут. Примеры: SetFont('Arial, 10, T, F, F', 1,1) - в ячейке A1 будет установлен шрифт Arial жирным начертанием (не курсив и без подчеркивания). SetFont(', , , T, F', 2,1) - в ячейке B1 будет поменяется только начертание курсив и будет отменено подчеркивание (если оно было).

SaveValuesOnly - убирает формулы на текущей странице и оставляет лишь их результативные статичные значения.

'''''Цвета'''''

SetRowFontColor(Row,Color) - Устанавливает цвет шрифта в строке Row. Color - целое значение (RGB)

SetRowColor(Row,Color) - Устанавливает цвет фона в строке Row. Color - целое значение (RGB)

SetColumnFontColor(Col,Color) - Устанавливает цвет шрифта в столбце Col. Color - целое значение (RGB)

SetColumnColor(Col,Color) - Устанавливает цвет фона в столбце Col. Color - целое значение (RGB)

SetCellFontColor(Row,Col,Color) - Устанавливает цвет шрифта в ячейке с координатами [Row,Col]. Color - целое значение, равное номеру цвета в палитре (ColorIndex,не RGB)

SetCellColor(Row,Col,Color) - Устанавливает цвет фона в ячейке с координатами [Row,Col]. Color - целое значение (RGB)

GetRowFontColor(Row)- Возвращает RGB значение цвета шрифта строки Row

GetRowColor(Row)- Возвращает RGB значение цвета фона строки Row

GetColumnFontColor(Col)- Возвращает RGB значение цвета шрифта столбца Col

GetColumnColor(Col)- Возвращает RGB значение цвета фона столбца Col

GetCellFontColor(Row,Col) - Возвращает номер цвета шрифта в палитре (ColorIndex) в ячейке с координатами [Row,Col]

GetCellColor(Row,Col) - Возвращает RGB значение цвета фона в ячейке с координатами [Row,Col]

'''''Копи-паст'''''

Copy(x1, y1, x2, y2) - Копирует в буфер экселя

Cut(x1, y1, x2, y2) - Вырезает в буфер экселя

Paste(x1, y1) - Вставляет из буфера экселя. Команды copy-paste неразрывны, если что нибудь сделать в промежутке между ними, например вставить значение в ячейку, то копирование сброситься. (Последовательность использования: copy - paste, cut - paste)

PasteStyle(x1, x2, y1, y2) - Вставляет только оформление из буфера экселя (Последовательность использования: Copy - PasteStyle)

'''''Изображения'''''

InsertPicture(TPicture, [x=1, y=1, DispX=0, DispY=0, width=0, height=0]) - Функция вставляет рисунок на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки, width, height (не работает для DirectExcel) - ширина и высота области рисунка в пойнтах-единицах Excel

InsertFirmLogo(FirmCode, [x=1, y=1, DispX=0, DispY=0]) - Функция вставляет логотип фирмы с кодом FirmCode на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки.

'''''Вывод'''''

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки. Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SheetFitPageWidth - устанавливает режим масштабирования печати, чтобы печатная форма помещалась в ширину на один лист.

SetOrientation(value) - Устанавливает ориентацию страницы. True (по-умолчанию) - альбомная (ландшафтная), Ложь - портретная.

PrintOut([copies]) - Печатает текущий лист на принтере по умолчанию. Параметр copies - количество копий, по умолчанию равен 1.

Save(filename) - Сохраняет в файл filename. Если файл существует, в основной системе он будет перезаписан, в других проектах - вызовет ошибку "Файл уже существует".

SetVisible(b) – Устанавливает видимость приложения Excel для пользователя. По-умолчанию – false (не видимо).

DoNotDestroy(b) – При уничтожении объекта TExcel (а он уничтожается, как и все остальные объекты автоматически при завершении выполнения скрипта), приложение Excel уничтожается вместе с ним. DoNotDestroy(true) отключает уничтожение приложения.

'''''Пример использования'''''

new('TExcel', 'myxl');
myxl.OpenFile('c:\asdf.xlsx');
set($sum, 0);
while (myxl.EOF=0,
set($sum, $sum+int(myxl.c));
myxl.next );
$sum

''Возвращает сумму всех числовых данных столбца C файла 'c:\asdf.xlsx'''

== Объект TDirectExcel ==
Объект позволяет работать с файлами Excel напрямую, без установленного пакета MsOffice. Применяется в сервисах и при отсутствии экселя. Он максимально совместим с объектом TExcel, однако некоторые методы могут быть не реализованы.

== Объект TCSVFile ==
Предназначен для доступа к данным документов CSV. Разделителем столбцов является символ точка с запятой ;

Функции:

FileName – Возвращает имя текущего файла.

OpenFile(FileName) – Открывает файл FileName.

LoadFromDB(DB[, Headered=false]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO.

LoadFromText(s) - Загружает таблицу из строки s.

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки.

SaveToFile(Filename) - Сохраняет в файл с именем filename.

== Объект TADO ==

Предназначен для доступа к базам данных.

Функции:
{| class="wikitable"
!Функция
!Описание
|-
|Connect(ConnectionString)
|Подключает к источнику данных. ConnectionString – Строка подключения ADO.
|-
|ConnectMySQL(DBServer, DBPort, DBUser, DBPass, DBName)
|Подключает к базе данных MySQL.
|-
|Open(Query)
|Открывает набор данных выполнив запрос Query.
|-
|FieldByNo(i)
|Возвращает значение поля с номером i. Нумерация полей – с нуля.
|-
|FieldName(i)
|Возвращает имя поля с номером i.
|-
|FieldCount
|Возвращает количество полей.
|-
|RecordCount
|Возвращает количество записей.
|-
|RecNo
|Возвращает номер текущей записи. ''ВНИМАНИЕ! В зависимости от способа подключения к БД нумерация может начинаться как с 0 так и с 1!''
|-
|EOF
|Возвращает признак достижения конца набора данных. Становится истиной когда выполняется команда Next на последней записи.
|-
|Next
|Переход на следующую запись набора.
|-
|First
|Переход на первую запись набора.
|-
|Last
|Переход на последнюю запись набора.
|-
|FieldByName(FieldName)
|Возвращает значение поля по имени. Также возможно указание имени поля как свойства объекта.
|-
|Field(Table, ID, FieldName)
|Возвращает значение поля FieldName записи с кодом ID таблицы Table. Набор данных, если он открыт, при этом не закрывается. Первичный ключ таблицы должен называться «code». Гарантированно работает только с MYSQL!!!
|-
|GetSQLValue(Query)
|Выполняет SQL-запрос. Текст запроса должен начинаться с первого символа строки (перед запросом не должно быть пробелов, переносов строк, комментариев и т.д.). Если запрос Insert – возвращает ID вставленной записи. Если запрос – Update, Delete, Replace, Set, Start, Commit, Rollback – возвращает количество измененных записей (RowsAffected), иначе – Select – значение первого поля первой строки результата как текст.
|-
|FillText(s)
|Возвращает строку s с замененными названиями полей между знаками процента на соответствующие значения текущей записи. Так же в строке возможно использование интерпретируемого кода, заключенного между тегами "<?>" и ">". При интерпретации система сначала производит замену полей с процентами на значения, потом интерпретирует код. ''Внимание! Функция не создает отельный контекст интерпретатора, а использует существующий, в нем доступны все объекты и переменные, вызывающего скрипта.'' Дополнительно автоматически создается объект TSelfADO, подключенный к той же БД, что и контекст, вызвавший функцию, с пустым именем, а так же с именем "dataset".
|-
|Query(Query)
|Синоним GetSQLValue.
|-
|Close
|Закрывает набор данных.
|-
|Self
|Возвращает указатель на подключение к БД для использования в других объектах.
|-
|ParseForIn([FieldName='code'])
|Возвращает через запятую значения всех строк в указанном столбце. По умолчанию, используется столбец с именем code.
|-
|GetSQL
|Для отладки. Возвращает последний SQL запрос переданный в методы Open, Query, GetSQLValue
|-
|ExportExcel
|Для отладки. Выгружает в эксель содержимое датасета. Можно использовать в незнакомом окружении для понимания передаваемых полей в : шаблонах, печатных формах и т.д. Аналог команды %echo% в шаблонах, на случай если она не сработает.
|-
|OnGetText
|Функция подменяет текстовый вывод значения поля при выгрузке в эксель. Первый параметр это имя поля, которое надо подменить. Второй параметр это то что необходимо вывести. Работает только с текстовыми полями.
'''''Пример использования'''''
DB.OnGetText('Зона', IF((DB.FieldByName('-Lat') ! 0) * (DB.FieldByName('-Lon') ! 0),
GetPolygonByLatLon(DB.FieldByName('-Lat'), DB.FieldByName('-Lon'), 'TYPE = 1 AND IFNULL(zone, 0) > 0 AND PRICE = ' + DB.FieldByName('-price'), 'zone')
,
''
));
|}

Пример использования – см. TSelfADO

== Объект TSelfADO ==

Наследник объекта TADO. Служит для подключения к «родной» для программы, в которой выполняется скрипт, базе данных. Обладает всеми свойствами и методами объекта TADO, кроме Connect. Иногда автоматически создается системой для обеспечения простого доступа к базе данных, а также иногда создается системой с уже открытым набором данных для передачи обрабатываемого системой набора данных в скрипт. В этом случае для скрипта недоступны функции Open и Close.

Пример использования:

rem('Копируем данные из "родной" базы данных в базу MSSQL.');
new('TSelfADO', 'MyDB');
new('TADO', 'MSSQL');
MSSQL.Connect('Provider=SQLOLEDB.1;Password=myPassword;Persist Security Info=True;User ID=myUsername;Initial Catalog=myDataBase;Data Source=myServerAddress');
MyDB.Open('select code, name, passport from kurier where code>'+Int(MSSQL.Query('select max(code) from kurier'))+' order by code');
While(MyDB.EOF=0,
MSSQL.Query('insert kurier (code, name, passport) VALUES ('+MyDB.Code+', '+QuotedStr(MyDB.Name)+', '+QuotedStr(MyDB.Passport)+')');
MyDB.Next;
);

== Объект TPrinter ==

Предназначен для доступа к принтерам.

Функции:

BeginDoc – Начинает новый документ.

EndDoc – Закрывает документ

PageHeight – Возвращает высоту страницы в пикселях

PageWidth – Возвращает ширину страницы в пикселях

PageNumber – Возвращает номер текущей страницы документа

Orientation – Возвращает текущую ориентацию страницы (0 – портретная, 1 – ландшафтная)

Printing – Возвращает истину если документ открыт

SetOrientation(Orientation) – Устанавливает ориентацию страницы. При необходимости начинает новый документ, новую страницу.

ShowDialog – Показывает пользовательский диалог печати. Возвращает истину, если пользователь нажал "OK".

NewPage – Начинает новую страницу

Canvas – Предоставляет доступ к объекту TCanvas, связанному с принтером.

PrinterNames – Возвращает список принтеров, установленных в системе, разделенный переносами строк

PrintersCount – Возвращает количество установленных в системе принтеров

SetPrinter(Printer) – Устанавливает текущий принтер. Если передана строка – ищет принтер по названию, иначе – по номеру. Нумерация начинается с 0.

PrintTable(Y, Table) – Выводит на печать таблицу Table типа TTable, начиная с координаты Y. При необходимости таблица печатается на нескольких страницах. Возвращает координату Y конца таблицы.

GetDefaultPrinter - Возвращает имя текущего активного принтера.

SetDefaultPrinter(Printer) – Запоминает предыдущий активный принтер и устанавливает новый текущий принтер. Printer - имя принтера. При необходимости нескольких последовательных вызовов SetDefaultPrinter рекомендуется между вызовами использовать RestoreDefaultPrinter.

RestoreDefaultPrinter - Устанавливает активным принтер, который был текущим перед последним вызовом SetDefaultPrinter.

== Объект TCanvas ==

Предоставляет доступ к холсту объекта для прорисовки изображения.

Функции:

DPIX – Возвращает разрешение холста по горизонтали в точках на дюйм

DPIY – Возвращает разрешение холста по вертикали в точках на дюйм

TextOut(x, y, s[, x1, y1, x2, y2]) – Выводит строку s начиная с точки с координатами x и y. Если указаны параметры x1, y1, x2, y2 – то выводимый текст ограничивается заданным прямоугольником.

TextOutEx(x1, y1, x2, y2, Alignment, Font, s, Indent) – Выводит строку s в прямоугольнике с координатами x1, y1, x2, y2. По горизонтали строка выравнивается в соответствии с Alignment (0 – прижато влево, 1 – вправо, 2 – по центру), по вертикали выравнивается по центру. Используя шрифт Font (см описание ниже). Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату X фактического окончания текста (правой стороны – если строка прижата влево, и левой – в остальных случаях)

MLTextOut(x1, y1, x2, y2, Alignment, VAlignment, Font, s, Heigth, Indent) – Выводит многострочный текст s в прямоугольнике с координатами x1, y1, x2, y2 с переносом по словам. По горизонтали строки выравниваются в соответствии с Alignment, по вертикали – в соответствии с VAlignment (0 – прижато вверх, 1 – по центру, 2 – прижато вниз). Используя шрифт Font (см описание ниже). Heigth – высота строки. Если опущено или равно нулю – высота определяется автоматически в соответствии с выбранным шрифтом. Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату Y фактического окончания текста (нижней границы последней строки текста. ''ВНИМАНИЕ! Функция использует координаты прямоугольника для позиционирования текста, однако она не ограничивает его верхней и нижней границами этого прямоугольника!''

DrawPic(x1, y1, x2, y2, Pic, Style, Alignment, Mode) – Прорисовывает изображение Pic (ссылка на изображение TPicture.Self) в прямоугольник заданный координатами x1-y2. Style – стиль масштабирования. 0 – растянуть изображение до границ прямоугольника не сохраняя пропорции, 1 – вписать изображение в прямоугольник сохраняя пропорции – вероятно, останутся поля по вертикали или горизонтали, 2 – вписать сохраняя пропорции, обрезав при необходимости изображение по вертикали или горизонтали. Alignment – выравнивание по горизонтали. Работает только в случае если style=1 и при растягивании изображения получились вертикальные поля. 0 – разместить по центру, 1 – прижать влево, 2 – прижать вправо. Функция возвращает координату X правой стороны изображения кроме случая, когда Style=1 и Alignment=2 – в этом случае возвращается координата левой стороны изображения. Mode - способ наложения изображения. 0 (по-умолчанию) - копирование как есть. 1 - Наложение операцией AND (применяется для получения эффекта прозрачности изображения), 2 - наложение операцией XOR (Применяется для возможности повторной операцией убрать изображение), 3 - Наложение операцией OR.

FillRect(x1, y1, x2, y2) – Рисует прямоугольник '''без границ''' и закрашивает цветом BrashColor

Rect(x1, y1, x2, y2) – Рисует прямоугольник '''c границами''', задаваемыми текущим пером, и закрашивает цветом BrashColor

SetFont(Font) – Устанавливает шрифт по-умолчанию.

SetPen(Width, Color) - Устанавливает параметры "ручки" - толщину и цвет. Если любой параметр опустить, соответствующее значение не будет изменено.

SetBrush(Color, Style) - Устанавливает параметры заливки - цвет и стиль. Если любой параметр опустить, соответствующее значение не будет изменено. Стили заливки: 0 - сплошная, 1 - отсутствует (прозрачная), 2-7 - различные виды штриховки (горизонтальные, вертикальные, в клеточку и т.д.).

TextHeight(s) – Возвращает высоту текста s в пикселях без учета многострочности, с учетом текущего шрифта.

TextWidth(s) – Возвращает ширину текста s в пикселях без учета многострочности, с учетом текущего шрифта.

Использование шрифта (Font): У объекта TCanvas есть «глобальные» установки шрифта. Однако для некоторых функций возможно указание шрифта, отличающегося от глобального. Параметры шрифта – это текстовая строка, состоящая из 6-ти параметров, разделенных запятыми: Название, размер, жирный, курсив, подчеркнутый, цвет. Например:

'Times New Roman, 8, Y, N, N, 255'

Любой параметр можно опустить, и тогда вместо него будет использовано значение по-умолчанию: шрифт: arial, размер – 10, не жирный, не курсив, не подчеркнутый, цвет – черный. Например: ', 7' – указывает, что по-умолчанию нужно взять все параметры кроме размера шрифта. Также можно вместо всей строки указать тире ('-') или пустую строку, и шрифт будет использоваться «глобальный».

Объект можно создать отдельно, не создавая объект TPrinter. В таком случае объект создастся как ссылка на текущий холст принтера (принтер должен быть запущен и начат новый документ). Такой подход используется в доп. возможности PrintCustomSticker

== Объект TPicture ==

Предоставляет функции для работы с графическими изображениями форматов BMP, GIF, JPEG и PNG, а также для формирования штрих-кодов. Обратите внимание, прозрачность изображений не поддерживается, однако в методе TCanvas.DrawPic есть параметр Mode, призванный создавать эффект прозрачности.

Функции:

LoadFromFile(FileName) – Загружает изображение из файла FileName. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromDB(DB, Query) – Загружает изображение из базы данных. DB – ссылка на подключение к базе данных TADO.Self, Query – текст запроса. Запрос должен вернуть в первом поле первой строки BLOB-поле с изображением, все остальные данные возвращаемые запросом игнорируются. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromStr($s) – Загружает изображение из строки $s. Возвращает истину, если операция прошла успешно, иначе – ложь.

CreateBar(Width, Height, BarCode, Textless, Type) – Формирует штрих-код шириной Width и высотой Height с типом кодирования Type. BarCode – текст штрих-кода. Булево значение Textless указывает, что в штрих-коде не должно быть человеко-читаемых символов если истинно. Type указывает тип кодирования: 0 (по-умолчанию) CODE128, 1 - EAN-13, 2 - Interleaved 2-5, 3-DataMatrix, 4-QRCode.
Штрихкод должен быть: Для EAN-13 цифровым 12 или 13 символов (13-й, контрольная сумма рассчитывается автоматически), для CODE128 - должен иметь состоять из допустимого для этого кодирования набора символов. Для Interleaved - должен состоять из четного числа цифр, контрольная сумма автоматически не рассчитывается. Если для Interleaved кода указано значение из 14-ти знаков, подпись цифр выводится в формате Почты России.
Внимание! Для кодов EAN-13 и Interleaved ширина штрих-кода Width не является точным значением получаемого на выходе изображения. Ширина изображения рассчитывается как максимальное кратное минимально возможной ширине, но не меньше минимально возможной. Конечную ширину можно получить в соответствующем свойстве объекта. Для кода CODE128 штрих-код на выходе может оказаться пустым, если указанной ширины штрих-кода не достаточно для его формирования.
Для кода DataMatrix можно установить режим для печати скрытых символов с кодами 29(GS) и 232(FCN1), которые требуются для формирования Честного Знака. Для этого необходимо в начале строки указать символ "[" и все разделители 01, 21, 91, 92 так же экранировать этими скобками. Должно получиться [01]02900002317701[21]k3LInNbH_oG0Q[91]EE06[92]YXiyKfiHjE4YE8b+YVMC1O5r8VtpplA3AwcCqrcG9Dk= . При формировании кода, включится режим формирования штрих-кода DataMatrix GS1, в начале будет добавлен символ с кодом 232 (FCN1), а потом будут добавлены разделители с кодом 29 (GS)
Функция возвращает 1 в случае успеха, или текст ошибки, если такая произошла.

SetSize(Width, Height) - Устанавливает размер изображения.

AsString([ImageFormat]) - Возвращает изображение в виде строки с двоичными данными. ImageFormat принимает значения 1 - Bitmap (по-умолчанию), 2 - jpeg, 3 - png, 4 - gif.

Width – Возвращает ширину изображения.

Height – Возвращает высоту изображения.

Rotate(Angle) – Поворачивает изображение по часовой стрелке на угол Angle. Угол указывается в градусах и может принимать любые значения.

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

Canvas - ссылка на объект TCanvas холста изображения.

== Объект TTable ==

Предоставляет функции для работы с таблицами. Удобен для печати таблицы на принтере. Алгоритм таков: Загружаем датасет в таблицу, настраиваем ее (шрифты, штрих-коды и т.д.), потом выводим на принтер функцией TPrinter.PrintTable.

Функции:

LoadFromDB(DB) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Заголовок – это первая строка таблицы.

Cell(С, R) – Возвращает значение ячейки таблицы с координатами (C, R). Нумерация строк и столбцов начинается с 1.

SetCell(С, R, Value) – Устанавливает значение ячейки таблицы с координатами (C, R) в Value. Нумерация строк и столбцов начинается с 1.

RowCount – Возвращает количество строк в таблице.

ColCount – Возвращает количество столбцов в таблице.

SetTitleFont(Font) – Задает шрифт заголовка таблицы (первой строки).

SetFont(Font) – Задает шрифт всей таблицы кроме заголовка.

SetColFont(C, Font) - Устанавливает шрифт столбца C.

SetIndent(Indent) – Задает отступ от границы ячейки до текста в процентах от ширины страницы. По-умолчанию значение 0.3

SetWidth(С, Width) – Задает значение ширины столбца C в процентах от ширины страницы.

SetMinRowHeght (Heght) – Задает значение минимальной высоты строки в пикселях.

SetBarCode(Col, Type) - Указывает, что данные из столбца Col должны печататься в виде штрих-кода. Тип штрих-кода - Type. Значение '''"1" - EAN13'''. Для кода EAN13 первая строка данных в ячейке должна иметь вид "тип штрих-кода, номер", например "7, 123" (без кавычек, конечно). В этом случае система сформирует штрих-код: "2700000001233". Первая цифра - всегда 2, далее - указанный тип штрих-кода, нули, чтобы получилось 13 символов, номер, указанный в таблице, и один символ - контрольная сумма. Значение '''"2" - CODE128''' (с версии 734). Данные из первой строки ячейки таблицы печатаются в штрих-коде "как есть". Для всех видов штрих-кода (с версии 734) последующие строки печатаются под штрих-кодом в виде текста.

SetMultiHeader(Active) - Включает печать заголовка при переносе таблицы на несколько страниц. По умолчанию отключено.

SetCustomHeader(script) - Включает печать пользовательского заголовка. Script - это код интерпретатора, который должен печатать заголовок на канву. Печать таблицы может происходить на нескольких листах, по этому скрипт будет вызван для каждого листа. При использовании этого метода, автоматически инициализируются переменные: $TablePageNo - номер страницы, нумерация начинается с нуля; $TableY - координата по оси Y, от которой рисуется заголовок. Чтобы таблица была под заголовком необходимо значение переменной $TableY увеличить на высоту заголовка.

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

Пример:
<?>
NEW('TPrinter', 'Prn');
If(prn.ShowDialog,
NEW('TTable', 'Tbl');
NEW('TSelfADO', 'MyDB');
MyDB.Open('SELECT concat("7", ", ", a.code, "\r\n", a.client_id, "\r\n", a.zakaz, "-", a.number) as "Штрих-код", a.target AS "Заказик", address, phone, vlog, poruch FROM address a order by code desc limit 10');
Tbl.LoadFromDB(MyDB.Self);
Tbl.SetBarcode(1, 1);
Tbl.SetCustomHeader(
if($TablePageNo>0,
Prn.Canvas.TextOut(Prn.Canvas.DPIX*0.1, $TableY, 'Продолжение таблицы');
set($TableY, $TableY + Prn.Canvas.TextHeight('H'));
,0)
);
Prn.BeginDoc;
Prn.PrintTable(0, Tbl.Self);
Prn.EndDoc
, );

== Объект TBaseUtils ==

Предоставляет функции, базирующиеся на БД системы «MEASOFT». По-умолчанию, при создании подключается к основной базе данных модуля, в котором выполняется скрипт, если такая определена контекстом, однако это можно изменить, см SetConnection.

Функции:

'''MakeAddress(s[,town])''' – возвращает значение, полученное путем преобразований адреса s для приведения его к внутреннему формату программы. В процессе преобразования до нескольких раз происходит замена буквосочетаний по таблице замены (ее редактирование доступно по нажатию кнопки «Автозамена» в интерфейсе импорта БД из Excel системы (см. Руководство пользователя)), поиск улиц по базе КЛАДР с точностью до одного знака, и некоторые другие операции, нацеленные на исправление ошибок в написании адреса.

С версии программы 2008.0.0.615, при вызове функции в формулах загрузки реестра, в первую очередь происходит проверка строки s на условия:
* в строке s записано число;
* строка s начинается с "ПВЗ ".
Если одно из этих условий выполняется, то функция пытается установить пункт самовывоза - т.е она сама в загружаемой карточке корреспонденции укажет: адрес ПВЗ, город ПВЗ и установит галку самовывоз. Правила поиска ПВЗ:
* Если s число - считаем его внутренним кодом филиала;
* Если s начинается с "ПВЗ " - Например в адресе передана строка "ПВЗ На Ленинском проспекте", то искать будем филиал с названием "На Ленинском проспекте" который подчиненный, активный, с галкой ПВЗ и в городе town. Если город не указан, то ищем филиал во всех городах, и считаем его найденным если найдем только один филиал.
* Если филиалы найти не удалось, функция makeaddress работает как обычно и выполняет преобразование адреса.

Если адрес не содержит русских букв, только латиница, и курьерская служба находится в одной из стран Россия, Белоруссия, Казахстан или Украина, и город-получатель (второй параметр, town) находится так же в одной из этих стран, функция автоматически делает транслитерацию адреса на русский язык.

''SetConnection(DB) – Подключает объект к базе данных DB, где DB – ссылка на объект TADO.Self.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

''SetTown(Town) – Устанавливает код текущего города (используется в некоторых функциях объекта) в значение Town. По-умолчанию текущий город – 1.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

'''SetIndexLength(Length)''' – Устанавливает длину почтового индекса. По-умолчанию – 6.

'''GetIndex(Address)''' – Возвращает почтовый индекс из адреса.

'''GetStreet(Address)''' - Возвращает улицу до первой запятой.

'''GetHome(Address)''' - Возвращает номер дома до второй запятой, но не более пяти символов.

'''GetKurierByStation(station, Mass, Cash, Date_Putn)'''

'''TownByIndex(Index[, PriorityName][, PriorityCountry])''' – Возвращает код города по индексу. В случае ошибки поиска – код текущего города. Если нашлось несколько населенных пунктов, и указано приоритетное название - выбирается населенный пункт, название которого начинается с PriorityName (если есть).

'''TownByName(Name[,NotNeedCL=False, City=0])''' – Возвращает код города по имени. В случае ошибки поиска – возвратит код текущего города. Если параметр NotNeedCL (параметр не обязательный) установить в TRUE, тогда функция возвратит 0, если город не удалось найти. Параметр City (код региона) позволяет ограничить поиск одной областью (не обязательный, по умолчанию не используется).

'''FillClientInfo(Excel, client, Sheet, Row, Col)''' – Выводит в эксель информацию о клиенте с кодом client на лист sheet начиная со строки row и столбца col.

'''SavePrintFormToFile(FormType, FormNumber)''' - Сохраняет на диске файл печатной формы и возвращает путь к нему

'''CreateTrans(Address[, Store][, Operator][,Correction])''' - Формирует запись для печати кассового чека для корреспонденции с кодом Address, для выбора кассового аппарата используется код склада Store. Если Store не указано - при исполнении в среде клиентского модуля системы использует склад, указанный пользователем в окне [[Настройка параметров рабочего места|"Настройка" - "Параметры"]], в остальных модулях - код текущего склада из [[Настройка глобальных параметров|переменной]] "CL" ("Текущий филиал"). Поле Operator позволяет указать кассира (передается код справочника сотрудников). Если не указан, в основной системе будет использован код авторизованного пользователя, в других модулях - 1.
Поле Correction позволяет указать данные для корректировочного чека, используется в системе Штрих-М. По умолчанию пустая строка. Возвращает идентификаторы записей чеков. Может вернуть пустую строку, если чек создавать не понадобилось, один или несколько кодов через запятую, если создано несколько чеков. В случае ошибки вызывает ошибку, поэтому рекомендуется использовать с функцией Try.

'''CreateReturnTrans(Address)''' - формирует запись для печати чека возврата для корреспонденции с кодом Address. Чек возврата печатается на полную сумму и с теми же атрибутами, что и чек продажи. Возвращает идентификатор записи чека возврата. В случае ошибки вызывает ошибку, поэтому, как и с CreateTrans, рекомендуется использовать с функцией Try.

'''CalcTownDeliveryDays(Source, Mode, TownTo, TownFrom)''' - возвращает количество дней необходимых на доставку отправления, только для межгорода. Source - код клиента, Mode - режим срочности, TownFrom - код города отправителя, TownTo - код города получателя.

'''CalcDeliveryDate(Source, Mode, TownTo, TownFrom, Date_Beg, Time_beg)''' - Возвращает планируемую дату доставки с учетом сроков доставки. Работает при городской и междугородней доставке. Для межгорода сроки доставки берутся из зон. Для городской доставки, из дополнительных параметров статуса (17 статус, 1 параметр в доп. информации) Если рассчитать дату планируемой доставки не удалось, возвращает пустую строку. Параметры: Source - код клиента, Mode - режим срочности, TownTo - город получатель, TownFrom - город отправитель, date_beg - дата заказа (может быть передана строкой в формате DD.MM.YYYY или в числовом), time_beg - время заказа.

'''GenSpecialSMA(DirectExcel, Code)''' - функция для генерации отчета о доставке по акту передачи денег. Первый параметр - указатель на TDirectExcel, второй параметр - код акта передачи денег. АПД выводится на текущий лист объекта TDirectExcel.

'''CreateSpecialSMA(ClientCode, DateTo)''' - Функция создает исходящий акт передачи денег (АПД). Требует ClientCode - код клиента, DateTo - дату акта. Функция возвращает коды созданных актов. Если возвращаемых параметров два, значит функция пыталась создать два АПД: первым, идет код АПД с наличной оплатой, а вторым с безналичной. Примеры возвращаемого результата: '0'- акт не был создан, отсутствуют корреспонденции; '124' - код созданного акта; '0,0' - пытались создать два акта, но отсутствуют данные; '4556,0' - создан только наличный АПД; '0,445' - создан только безнал.; '4556,445' - созданы нал. и безнал.

'''CreateAddressForActDelivery(ActCode, [DeliveryDateMode=0, Delivery=True])''' - Функция создает корреспонденцию на доставку акта. ActCode - код акта; DeliveryDateMode: 0 - установить план. дату доставки текущим рабочим днем, 1 - установить план. дату доставки следующим рабочим днем, 2 - установить план. дату доставки равной планируемой дате оплаты АПД; Delivery - создать корр. на доставку АПД или создать корреспонденцию на забор АПД (по умолчанию, доставка АПД). Работа функции может быть изменена системной доп. возможностью OnCreateAddressForActDelivery.

'''CreateAddressTransferAct(ClientCode, Store, DateTo, [AdditionalParam])''' - Функция создает исходящий акт передачи корреспонденции (АПК). Требует ClientCode - код клиента, Store - код филиала, для которого будет создан акт, DateTo - дату, до которой в акт попадут возвраты, AdditionalParam - дополнительный строковый параметр для передачи в системную доп. возможность ExceptionsForAPK, позволяющий отобрать в акт, например, только полные возвраты. Возвращает код созданного акта. ВНИМАНИЕ: при создании АПК используется системная функция ExceptionsForAPK. Если в ней используются интерактивные функции (вывод сообщений, диалоговые окна, выполнение скриптов), то акт сформирован не будет, а функция CREATEADDRESSTRANSFERACT вернет ошибку.

'''GetPolygonByAddress(Address, TownCode, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попал адрес. Если полигон найти не удалось, функция возвратит пустую строку. Address - адрес корреспонденции текстом; TownCode - код города; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByAddress(addressrecord.address, if((addressrecord.number=0)*(addressrecord.strbarcode=<nowiki>''</nowiki>), addressrecord.townfrom, addressrecord.townto), '`schema`=1') - пытаемся найти вхождение адреса в полигоны 1 схемы, при выборе города учитывается корр. на забор, у нее нужно использовать город-отправитель (а для обычной корр. нужен город-получатель).

'''GetPolygonByLatLon(Lat, Lon, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попали GPS координаты. Если полигон найти не удалось, функция возвратит пустую строку. Lat - широта текстом; Lon - долгота текстом; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByLatLon('55.769064','37.590713','zone is not null and price=0') - пытаемся найти вхождение координат в полигоны, где задана зона, для всех клиентских и курьерских зон.

'''GetLatLonByAddress(AddressText, TownCode)''' - возвращает географические координаты вида lat,lon указанного в AddressText адреса. Поиск производится в городе, имеющем код TownCode в таблице Town.

'''GetRouteCode(AddressText, TownCode, LatLon[, Lon])''' - для адреса AddressText в городе с кодом TownCode (из таблицы Town) по географическим координатам lat, lon возвращает код роута (записи, хранящей координаты адреса в городе). Если роут не найден (для адреса в городе не найдено записи с указанными координатами) - создает новый роут и возвращает его код, если роут найден (был создан ранее) - обновляет у роута координаты. Если параметр Lon задан, то параметр LatLon должен содержать одну координату, иначе LatLon должен содержать строку вида 'lat, lon'.
В случае ошибки возвращает Null.

Пример: 
Set($res, GetRouteCode(address, townto, '55.114034, 36.592397')); 
Set($res, GetRouteCode('Троицк, Полковника милиции Курочкина ул., 11', 1, '37.467446, 55.740537')); 
Set($res, GetRouteCode('Обнинск, Маркса пр., 20', TownByName('Обнинск'), 55.114034, 36.592397));

'''CalcAgentPrice(AddressCode, AgentCode, TownFrom, TownTo, Mode, [, Count=1])''' - функция возвращает стоимость доставки рассчитанную по тарифу агента. AddressCode - код адреса, AgenCode - код филиала (агента), TownFrom - код города отправителя, TownTo - код города получателя, Mode - режим срочности, count - тарифная сетку от указанного количества отправлений (по умолчанию 1)

'''SetAddrKol_vo(address, getkol_vo)''' - функция делает прием корреспонденции в текущем ответственном филиале. address - внутренний код адреса, getkol_vo - количество принимаемых мест, может принимать значения: "kol_vo" - принять все места, "getKol_vo+1" - принять еще одно место, "число" - сделать количество принятых мест равным указанному числу.

'''CalcClientCnt(client_code, date, is_intown [, date_put=CurrDate(), skipajust=false])''' - функция расчета количество доставленных корреспонденций у клиента с кодом client_code за предыдущий месяц от даты date (Или за текущий месяц, подробнее смотри переменную UseCurrentMonthCount) среди внутригородских (is_intown = true) либо междугородних (is_intown = false) корреспонденций, date_put - дата доставки (для альтернативного способа подсчета, включаемого переменной UseDatePutForCalcCnt), skipajust - не учитывать принудительно введенные количества (таблица priceclientadjust типы записей 0 и 1).

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset._self".
Описание некоторых полей датасета:
pmoney - процент от суммы;
pmoneycard - процент от суммы при оплате картой;
pricecode - код прайса (таблица Price) ;
distarea - район метро получателя (актуально при отключённом едином районировании, как правило район от 200 до 299 является признаком области);
region - признак области при включенном едином районировании;
distareaFrom и regionFrom - аналог distarea, region только для отправителя;
pcncode - код записи таблицы pricecnt "количество от";
Запрос содержит поля таблицы pricelinesnew - начальная стоимость по тарифной сетки, найденные без учета массы,только по типу срочности и режиму.
Запрос содержит поля таблицы price.

*addressrecord - ссылка на объектную модель карточки корреспонденции, следует использовать уже созданную addressrecord._self
*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*type - тип корреспонденции;
*mode - режим доставки;
*wait - количество минут ожидания (не учитывается при доп. услугах, есть системная услуга "ожидание");
*mass - масса отправления;
*rur - сумма передаваемых денег (не учитывается при доп. услугах, есть системная услуга "процент от суммы");
*inshprice - сумма страховки (не учитывается при доп. услугах, есть системная услуга "процент от объявленной стоимости");
*distance - расстояние до места доставки, обычно поле заполняется при доставке в область (регион в едино районировании). Дополнительная наценка к стоимости доставки;
*forward - направление доставки: true - туда; false - обратно;
*Collection - признак заборной корреспонденции: true - забор, false - доставка (В тарифе есть возможность указать стоимость для забора);
*TownFrom - код города отправителя;
*TownTo - код города получателя.

В тарифе есть возможность указать формулу, которая может влиять на базовый расчет. Формула может объявить служебные переменные, которые:
*$FormulaReplace - если true – возвращаемое значение полностью заменяет базовый расчет;
*$FormulaKoeff - коэффициент на который будет помножена базовая стоимость.
Также внутри формулы объявлены следующие объекты dataset, addressrecord и переменные:
*$ForceIntown - Переменная становится истиной, если междугородний расчет был отменен, т.к. адрес попал в нарисованную зону на карте.
*а также: $forward, $distance, $Count, $Collection, $Wait, $FormulaKoeff, $PriceCode - описание есть выше.

Для направления "туда", Функция GetBasePrice вызывается через доп. услугу "База" (при включенных доп. услугах), для направления "Обратно" всегда вызывается напрямую (т.к. доп. услуги работают только в для направления "туда").
На расчет этой функции влияют следующие переменные: "Финансы" -> "Расчет стоимости по адресу", "Финансы" -> "Зона клиента по умолчанию", "Финансы" -> "Подсчет кол-ва отправлений за месяц".

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset.self".

*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*tp - тип корреспонденции;
*mode - режим доставки;
*mass - масса отправления;
*TownFrom - код города отправителя;
*TownTo - код города получателя.

'''CalcAddressPrice(AddressCode, [,ZakazCount])''' - полностью пересчитывает стоимость доставки корреспонденции по тарифу клиента. AddressCode - внутренний код адреса, ZakazCount - не обязательный параметр, кол-во заказов от клиента.

'''GetStationCode(s [,town])''' – возвращает код станции метро, ассоциированный в системе с адресом s. В случае невозможности идентифицировать станцию метро – возвращает 0.
Когда включено районирование по карте, необходим второй параметр "town" - код города в котором нужно искать адрес. Возвращает код района если удалось его найти; код станции меж-города - если адрес удалось геокодировать, но район не нашли; код 0 - когда не удалось геокодировать адрес.

'''RecalcSpecialSMA(ActCode)''' - пересчитать акт передачи денег (АПД). Также, у корреспонденций входящих в АПД будет пересчитана стоимость доставки. Для Входящего АПД сумма акта не пересчитывается. Параметр ActCode - внутренний код акта, коды можно перечислять через запятую.

'''UserCode''' - Возвращает код текущего пользователя из таблицы «Пользователи» (users).

'''UserName''' - Возвращает имя текущего пользователя из таблицы «Пользователи» (users).

'''UserPass''' - Возвращает пароль текущего пользователя.

'''UserBaseCode''' – Возвращает код текущего пользователя из таблицы «Сотрудники» (kurier).

'''UserEmail''' - Возвращает e-mail текущего пользователя.

'''CurrentTown''' – Возвращает код текущего города (из таблицы town).

'''CurrentCity''' – Возвращает код текущего региона (из таблицы city).

'''CurrentLocation''' – Возвращает код текущего филиала (из таблицы store).

'''FromEmailStr''' - строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

'''FillExcelDoc'''(Excel, Dataset, FormType, FormNumber,Print,[printer]) - Выполняет указанную печатную форму в объекте excel. Excel объект можно не указывать, тогда функция сама создаст объект экселя и разрушит его, полезно когда книгу
нужно распечатать или отправить по email (на листе данных в ячейке 1,1 укажите ключевое слово email). Dataset объект с данными для скрипта в печатной форме, может быть null. Dataset передавать можно так db.self, тогда переданный dataset внутри печатной формы будет доступен по имени dataset. Print - печатает книгу на принтере, после печати объект excel разрушается, при использовании параметра не указываете объект excel. Printer - имя принтера, на котором печатать (по умолчанию пустая строка, что означает "печатать на принтере по умолчанию"). Например:

new('TExcel', 'excel');
FillExcelDoc(excel.self, null, 12, 1);
excel.DoNotDestroy(true);
excel.SetVisible(true);
''Покажет эксель с выполненной печатной формой''

'''ValutaSign''' – Возвращает название валюты для суммы.

'''SendToMeasoft(xml)''' - Отправляет запрос в клиентское API Measoft. Автоматически добавляет начальный "<?xml version="1.0" encoding="utf-8"?>".

'''InsertFirmAtt(excel, sheet, firmcode)''' - Вставляем на лист эксель по коду фирмы: печать, подпись, подпись бухгалтера, логотип. Тэги <STAMP>, <DIR>, <BUH>, <LOGO> соответственно. После тега можно указать размеры изображения в символах Microsoft Excel. Формат записи: <STAMP> 16, 16

'''PreCalcSalary(kurier, addressCodes)''' - Рассчитывает предварительную зарплату. Kurier - код курьера, используется для определения тарифа. addressCodes - коды адресов, через запятую для которых необходимо посчитать зарплату. Результаты расчета будут записаны в таблицу kurierpaydetail, так как расчет предварительный то записи не будут прикреплены к конкретному начислению.

select a.code, kpd.price as "туда", kpd2.price as "обратно" from address a
left join kurierpaydetail kpd on kpd.sourcetable=3 and kpd.sourcecode=a.code and kpd.rectype = 1
left join kurierpaydetail kpd2 on kpd2.sourcetable=3 and kpd2.sourcecode=a.code and kpd2.rectype = 2
where a.code in (...)

'''CalcSalary(DateTo, [Filter=0, KurierCode = 0, ManagerCode = 0])''' - Полный расчет зарплаты курьерам. DateTo - дата до которой создается начисление. Условия отбора курьеров для начисления. Filter - роль сотрудника: 0 - Все, 1 - курьеры, 2 - менеджеры; KurierCode - код курьера, ограничить расчет зарплаты одним курьером;ManagerCode - код курьера, ограничить расчет зарплаты курьерами указанного менеджера. Внимание фильтры Filter, KurierCode и ManagerCode накладываются друг на друга. Результатом функции является SubSQL с информацией по созданным начислениям.
поля ответа: код курьера, код менеджера, начислено, бонусы, штрафы, аванс, итого;
select kurier, manager, profit, bonus, shtraf, prepay, total [union select ...]

'''SelDistAddr(s)''' – Возвращает строку для вставки в select запрос, для вывода поля с упрощенным адресом. Принимает один необязательный строковый параметр - алиас таблицы из которой будет упрощаться поле address, по умолчанию "a"

'''VoiceReadStr(str)''' – Озвучивает фразу str голосовым уведомлением доступными словами из базы. Может содержать тег "{break_off}" для того, чтобы сделать эту фразу не пропускаемой в очереди воспроизведения.

'''CalcStorageCost(ClientCodes, DateFrom, DateTo, NeedReport[, Store])''' – рассчитывает стоимость хранения на складе для выбранных клиентов (ClientCodes - коды клиентов через запятую), в период дат с DateFrom до DateTo, с прикреплением к корреспонденции отчета в зависимости от выставленного параметра NeedReport. Может содержать параметр Store - код филиала, по умолчанию пустой (расчет выполняется для всех филиалов). Возвращает коды созданных корреспонденций через запятую.

'''WriteOut(DocId, ItemId, Date, Cnt[, BC])''' – производит списание товара со склада. DocId - код (docs.code) документа списания, ItemId - код товара (item.code), Date - дата операции, Cnt - количество списываемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер. Если указан BC, то параметр ItemId игнорируется и поиск номенклатуры происходит исключительно по штрих-коду. В случае успеха, функция возвращает строку вида: код номенклатуры, списанное кол-во.

'''IncomePurch(DocId, ItemId, Date, Cnt[, BC, Location = CurrentLocation])''' – производит приход товара на склад. DocId - код (docs.code) приходной накладной, ItemId - код товара (item.code), Date - дата операции, Cnt - количество приходуемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер, Location - код склада (store.code). В случае успеха, функция возвращает строку вида: код номенклатуры, введенное кол-во.

'''CreateLedgerDoc(Date, Client, UserCode, Type[, ExtNumber, Message])''' - создает складской документ и возвращает код этого документа. Date - дата документа. Client - код клиента. UserCode - код пользователя, создавшего документ. Type - тип документа (statetype = 13). ExtNumber - номер у поставщика для документов прихода и расхода. Message - комментарий к документу. Последние два аргумента не обязательные и могут быть пустыми.

== Объект TINIFile ==

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

Функции:

IniParam(s[,section='common']) – Существует только если имя экземпляра объекта пустое. Возвращает значение параметра s ini-файла секции «common», изменить секцию можно не обязательным параметром section. В случае отсутствия параметра в файле возвращает пустую строку.

Param(s) – Синоним IniParam с тем отличием, что существует только если имя объекта непустое.

SetText(s) - Загружает ini файл из строки s. Если в файле нет секции «common», то принудительно объявляет ее в начале.

== Объект TSMS ==

Предназначен для отправки SMS, а также проверки статуса их доставки.

Функции:

SetProxy(Server, Port, User, Pass) - Устанавливает настройки прокси-сервера.

Connect(Provider, Host, User, Pass, SenderName, SMSPrefix) – Подключает объект к провайдеру provider, используя адрес Host, имя пользователя User и пароль Pass. Значение SMSPrefix предназначено для того, чтобы провайдер мог различить сообщения от разных филиалов, если этими филиалами используется одно подключение. Если необходимости разделять сообщения нет - значение SMSPrefix можно не указывать.
Для провайдера доступны значения 'mirsms', 'sms16', 'websms', 'epochta', 'zanzara', 'SMSManager', 'f1sms', 'BitCall', 'mirsmsGET', 'AMD' и другие, либо можно указать числовые значения номера протокола, от 1 до <rspoiler text="20">Набор провайдеров все время дополняется, количество и номера можно смотреть в Справочники - Переменные - Подключения - SMS</rspoiler> соответственно. Эти значения соответствуют значениям переменной SMSProtocol таблицы "Value".

SendSMS(Phone, Text, [ID]) – Отправляет SMS с текстом Text на телефон Phone. Для некоторых провайдеров необходим уникальный идентификатор сообщения ID (для провайдера iVoice - идентификатор сценария (кампании)). Возвращает ID провайдера для последующей проверки статуса доставки.

CheckSMS(ProviderID) – Проверяет состояние доставки сообщения с идентификатором ProviderID. Возвращает: 0 – доставляется, 1 – успешно доставлено, 2 – не доставлено.

ReceiveSMS(InboxID, DateFrom, DateTo, NewOnly) - Получает входящие SMS, с ящика InboxID (идентификатор выдаётся провайдером). DateFrom, DateTo - задается временной интервал в котором были приняты сообщения(формат 08.04.2013 18:00:00 'DD.MM.YYYY HH:NN:SS'). Чтобы получать только новые сообщение поле NewOnly должно быть True. Возвращает XML с сообщениями.

ExtraResult([ParamName='']) - Вызывается после CheckSMS, возвращает дополнительную информацию по последнему статусу смс. В настоящее время работает только для провайдеров BitCall и iVoice. Для BitCall по умолчанию возвращает кнопки, нажатые абонентом во время работы с голосовым меню. Если в paramname указать 'IdentifyText' то будет возвращен JSON с ответами абонента на заданные вопросы(используется в случае звонков с индивидуальным сценарием). Для iVoice по умолчанию подразумевается параметр 'response', при этом будет возвращен JSON с ответами абонента на заданные вопросы (в зависимости от сценария)

Log - Возвращает последний HTTP запрос и ответ от сервера смс.

== Объект TXML ==

Предназачен для парсинга XML-данных.

Функции:

SetText(S) – Задает текст XML документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию. Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

AttribCount – Возвращает количество атрибутов текущего элемента.

AttribName(i) – Возвращает имя атрибута с номером i.

Attrib(V) – Ищет атрибут и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

Reset – Делает текущим корневой элемент, возвращает его значение.

== Объект TJSON ==

Предназачен для парсинга JSON-данных.

Функции:

SetText(S) – Задает текст JSON документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Можно проверять наличие элементов, если элемента нет, вернется пустая строка.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

Reset – Делает текущим корневой элемент, возвращает его значение.

isArray - Возвращает true, если текущий элемент является массивом (доступ к дочерним элементам возможен только по индексу, нумерация элементов начинается с нуля)

==Объект TZip==
Предназначен для работы с Zip архивом.

SetZip(s) - Загружает архив в объект из строки s;

GetZip - Возвращает архив в виде строки;

AddFromFile(SrcPath, ZipPath) - Добавляет файл SrcPath в архив и располагает его по пути ZipPath. ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

AddFromStr(Data, /*ZipPath*/) - '''параметр ZipPath временно не работает'''. Добавляет файл из строки Data в архив и располагает его по пути ZipPath. -ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

LoadFromFile(path) - Загружает архив из файла path;

SaveToFile(path) - Сохраняет архив в файл path;

Count - Возвращает кол-во файлов в архиве;

DataByIndex(index) - Возвращает распакованный файл в виде строки. Index - номер файла в архиве;

DataByName(ZipPath) - Возвращает распакованный файл в виде строки. ZipPath - путь к файлу в архиве, может содержать каталоги;

FileName(index) - По номеру файла, функция возвращает полный путь файла в архиве.

==Объект TBase==

'''Функции общего назначения''':

'''ExecSimpleScript(Caption, Text)''' - Выполняет скрипт "Дополнительных возможностей". Возвращаемые значения, введенные пользователем устанавливает в переменные $scriptvar1..$scriptvarN, Значения кодов списочных переменных - в переменных $scriptvar1codes..$scriptvarNcodes. Функция возвращает истину, если пользователь нажал "OK" в диалоговом окне.

'''FillAdvPriceReport(Excel, AddressCodes, StartLine, StartCol, [ShowSumPrice,InsertColumns,ShowAll])''' - добавляет отчёт по дополнительным услугам. В AddressCodes - указаны коды адресов через запятую, каждый код это отдельная строка отчета. Адреса будут показаны в порядке перечисления их в AddressCodes. Если в отчет нужно добавить пустую строку, то можно указать код адреса -1000. StartLine, StartCol - верхний левый угол выгружаемой таблицы. ShowSumPrice - добавить столбец итоговый столбец с суммой всех услуг, по умолчанию выключено. InsertColumns - раздвинуть таблицу перед вставкой отчета, позволяет встраивать отчет посередине выгрузки, по умолчанию выключено. ShowAll - показать все дополнительные услуги, по умолчанию false и показывает только услуги с начислениями. Функция возвращает количество использованных столбцов.

'''PrintSticker(Codes, [ToBoxes=False])'''

'''PrintBlanc(Codes, BlancNumber)''' - печатать форму из раздела "Заполнить бланк". Codes - коды корреспонденций, BlancNumber - номер формы из раздела "Бланки для корреспонденции" (3)

'''GetItemByName(Name)'''

'''GetA4Printer([GetPrinterPort=False])''' - возвращает имя принтера выбранного для печати документов. GetPrinterPort - попытаться по имени принтера найти порт принтера, используйте для печати через команду ghostscript. Определение порта работает только с физическими устройствами LPT, USB, TCPIP.

'''GetStickerPrinter([GetPrinterPort=False])''' - возвращает имя принтера выбранного для печати стикеров. GetPrinterPort - попытаться по имени принтера найти порт принтера, используйте для печати через команду ghostscript. Определение порта работает только с физическими устройствами LPT, USB, TCPIP.

'''GetDuplexPrinter([GetPrinterPort=False])''' - возвращает имя принтера выбранного для двусторонней печати, если принтер не выбран, возвращает пустую строку. GetPrinterPort - попытаться по имени принтера найти порт принтера, используйте для печати через команду ghostscript. Определение порта работает только с физическими устройствами LPT, USB, TCPIP.

'''PrintAttachPDFPage(Code, FileName, Page, Printer)''' - печатает страницу из вложенного файла PDF. Code - код вложения (attachment) или путь к файлу, Page - номер страницы, Printer - 0 = принтер A4, 1 = принтер этикеток.

'''AttachPDFToText(Code, [TextFileName])''' - преобразует файл PDF из вложений в текст. Code - код вложения (attachment) или путь к файлу, TextFileName - имя текстового файла, в который записывается результат (если не указан, используется временный файл). Возвращает текст в виде строки.

'''GhostScript(GScript, Code)''' — функция для выполнения консольных команд утилиты [https://ghostscript.readthedocs.io/en/latest/Use.html ghostscript]. Где, GScript — строка с командами Ghostscript; Code — код вложения или путь к PDF-файлу, предназначенному для обработки. В командах доступен специальный тег %MeasoftInFile%, который автоматически заменяется на путь к предварительно загруженному файлу (Code). Если в команде необходимо указать путь для сохранения результата обработки, используйте тег %MeasoftOutFile%. В этом случае функция на основании параметра Code автоматически сформирует имя временного выходного файла. После успешного выполнения команд функция возвращает путь к сгенерированному выходному файлу - %MeasoftOutFile%.

'''GetActiveForm([SkipFormName])''' - возвращает код активной формы в программе где происходит сканирование. SkipFormName - не обязательны параметр, имя формы которую нужно пропустить при определении интерфейса.
'''Список интерфейсов''':
0 - неопределенный;
1 - прием корреспонденции на склад;
2 - АПД;
3 - комплектация адресов (ShelfingForm);
4 - доска приема;
9 - вкладка «Манифесты»;
10 - Инвентаризация корреспонденции;
11 - АПК;
12 - вкладка «Адреса»;
13 - вкладка «Выдача»;
14 - вкладка «Склад»;
15 - Список номенклатуры;
16 - Инвентаризация склада;
17 - Приходная накладная;
18 - Списание товара;
19 - Карточка корреспонденции.

'''AddAddressScanLog(Code[, StrBarCode, IsManual, FromInterface, ExtraInfo])''' - добавляет событие сканирование для корреспонденции с кодом Code. Необязательные параметры: StrBarCode - сканируемый ШК корреспонденции (по умолчанию пустой), IsManual - галка ручного сканирования (по умолчанию false), FromInterface - код интерфейса сканирования (StateType=81, по умолчанию 0 - неопределенный), ExtraInfo - текстовый комментарий события.

'''RuleName(alias)''' - Выдает полный путь в дерева прав по псевдониму права.

'''ShowText(Caption:string, Value:string)''' - показывает пользователю окно с заголовком Caption и с многострочным полем со значением Value. Может быть полезен при отображении логов выполненной операции.

'''ShowScanError(msg [, Speek, Color, Abort])''' - выдает пользователю окно с текстом msg блокируя последующие действия сканирования. Если Speek - истинно, то сообщение проговаривается голосовым движком, по умолчанию выключено. Color - целочисленное число цвета, в который будет окрашен фон сообщения (по умолчанию = -1, стандартный). Abort - прервать выполнение скрипта, не показывая ошибку.

'''CheckRule(alias)''' - функция проверки разрешения у текущего пользователя системы, alias - псевдоним права. Возвращает 1, если право есть и 0, если права нет.
Пример: if(CheckRule('RSE'), ShowMessage('У пользователя есть право изменять счета'), ShowMessage('У пользователя нет права изменять счета'));

'''GetKurierMoney(KurierCode, DateEnd, NonCash)''' - возвращает баланс курьера с кодом KurierCode на дату DateEnd. NonCash - булевый флаг, если истинно, то будет рассчитан безнальный баланс;

'''Функции, работающие только в импорте БД из эксель:'''

ReplaceAddress

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

GetPrice

GetNewNumber - используется при импорте реестра, возвращает номер конверта в загружаемом заказе

GetNewPos - используется при импорте реестра, возвращает порядковый номер вложения

GetNewPackagePos- используется при импорте реестра, возвращает порядковый номер места

Zakaz - возвращает номер заказа куда происходит импорт реестра

addresscode - используется при импорте реестра, код созданного адреса

Source - код заказчика

ClientTown - Узнаем город клиента, через филиал с которым он работает. Сам клиент берется из заказа указанного в окне "Импорт БД из Excel".

== Объект TFieldObject ==
Создается только автоматически. Объект для доступа к записям, используется в картах и дополнительных услугах (addressrecord) и событиях карточки корреспонденции (fieldlist). Методы объекта:

'''_GetTableInfo''' - возвращает данные о полях и примеры данных объекта.

'''_Self''' - возвращает ссылку на объект.

'''_Set(fieldname, fieldvalue [, DoUpdateForm])''' - Если базовый объект строка. Устаналивает для поля fieldname значение fieldvalue. DoUpdateForm по уолчанию false, если указать true то обновление поля будет не только в объекте но и пользовательском интерфейсе. Обновление работает только в карточке корреспнденции для ограниченного набора полей: vlog, mode, type, date_put, time_put, message, kurier, state1.

'''_Set(keyfield, keyvalue, filed, value)''' - Если базовый объект таблица (addressrecord.boxes). Работает перегруженная версия метода _set, cначала происходит поиск строки по ключу, далее меняется значение указанного столбца. keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Пример, отключение услуги база:

addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

== Объект TMessage ==
Создается только автоматически. Объект используется для скриптовой обработки письма в [https://wiki.courierexe.ru/index.php/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F_%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8#.D0.98.D0.BC.D0.BF.D0.BE.D1.80.D1.82_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85| заданиях импорта данных]. В себе содержит текст письма в очищенном формате и оригинальном формате HTML, отправитель письма, тему письма, дата получения и список прикрепленных файлов.

'''Message.Text''' - возвращает очищенный от HTML-тегов текст письма.

'''Message.HTMLText''' - возвращает оригинальный текст письма со всеми HTML-тегами.

'''Message.Sender''' - возвращает email-адрес отправителя письма.

'''Message.AttachmentsCount''' - возвращает количество вложенных файлов.

'''Message.DateTime''' - возвращает дату и время получения письма.

'''Message.Subject''' - возвращает тему письма.

'''Message.GetAttachmentDataString(Number)''' - возвращает вложенный файл под номером Number в виде строки.

'''Message.GetAttachmentName(Number)''' - возвращает имя вложенного файла под номером Number.

== Объект TStringList ==
Может использоваться для построчной обработки многостраничных файлов либо для организации текстовых данных. Номер строк начинается с 0.
Имеет следующий функционал:

'''Count''' - возвращает количество строк в списке.

'''Add(Value:string)''' - добавляет значение Value в конец списка.

'''SetText(Value:string)''' - устанавливает значение списка в значение Value.

'''Insert(Number:integer, Value:string)''' - добавляет строку Value в позицию Number.

'''Delete(Number:integer)''' - удаляет строку из списка в позиции Number.

'''Clear''' - очищает элементы списка.

'''LoadFromFile(Path:string)''' - загружает текстовый файл по пути Path.

'''Strings(Number:integer)''' - возвращает строку с номером Number.

'''SetString(Number:integer, Value:string)''' - устанавливает значение строки с номером Number в значение Value.

'''Text''' - возвращает полный список строк в виде текста.

'''CommaText([Quoted:boolean])''' - возвращает список значений через запятую. Если Quoted = true, то квотирует элементы списка. По умолчанию равен false.

'''SetCommaText(Value: string)''' - разбивает значение Value на отдельные строки и кладет в список. Разделитель - запятые.

'''IndexOf(Value:string)''' - ищет значение Value среди элементов списка и если находит, то возвращает номер строки. Возвращает -1 если значение не было найдено.

'''Sorted(Value:boolean)''' - устанавливает флаг отсортированности списка в Value. Если Value = true, то сразу же его сортирует. По умолчанию Value = false.

'''Exchange(Pos1:integer, Pos2:integer)''' - меняет элементы списка с позициями Pos1 и Pos2 местами.

'''Duplicates(Value:integer)''' - изменяет параметр управления дубликатами в списке. Если Value = 0 (значение по умолчанию), то список не реагирует на дубликаты. Если Value = 1, то список при добавлении будет игнорировать дубликаты. Если Value = 2, то список будет выдавать исключение, при добавлении дубликата в список.

'''ParamName(Number:integer[, Delimiter:string])''' - возвращает текст до первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает пустоту.

'''ParamValue(Number:integer[, Delimiter:string])''' - возвращает текст после первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает всю строку.

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

Основные методы:

'''New'''(FuncName, Param1, Param2, ..., Body) — создание новой функции.Функция возвращает результат выполнения последней команды в теле функции. Аргументы:
* `FuncName` — имя функции (строка)
* `Param1, Param2, ...` — имена параметров функции (переменные начинаются с `$`, объекты — без префикса)
* `Body` — тело функции (скрипт, выполняемый при вызове)

'''FuncName'''(Arg1, Arg2, ...) — вызов созданной функции по имени. Если в объявлении была указана тип переменная, то и подставлять в аргумент надо обязательно переменную. Будет передано значение этой переменной (переменные словарине поддерживаются!). Если был объявлен объект, то указатель на объект должен быть получен через метод '''_self'''. C функциями поддерживают работу следующие классы: TExcel, TDirectExcel, TCSVFile, TADO, TSelfADO, TPrinter, TCanvas, TPicture, TTable, TINIFile, TSMS, TXML, TJSON, TZip, TStringList, TBaseUtils, а также объект addressrecord (TFieldObject). Результатом работы функции может быть число или строка.

Пример 1, обработка результатов функции:
<source>
<?>
new('TFunc', 'calc');
calc.new('Sum', '$a', '$b',
$a + $b
);

set($x, 10);
set($y, 20);
showmessage(calc.Sum($x, $y));
</source>

Пример 2, передача объекта в функцию:
<source>
<?>
new('TFunc', 'utils');
utils.new('ProcessDB', 'dbConn', '$value',
showmessage($value);
dbConn.open('SELECT * FROM address limit 3 ');
if(dbConn.recordcount > 0,
showmessage('Найдено записей: ' + dbConn.recordcount);
dbConn.first;
while(dbConn.eof = 0,
showmessage(dbConn.fieldbyname('code'));
dbConn.next
)
,0)
);

new('TSelfADO', 'db');
utils.ProcessDB(db._self,'test!');
</source>

== Применение языка формул ==
'''в различных контекстах системы «MEASOFT» и сопутствующих проектах'''

=== MEASOFT ===

==== Дополнительная информация на чеке ====

В карточке клиента на закладке «Касса» имеется поле для ввода текста, который будет отображаться на кассовых чеках, печатаемых для корреспонденции от данного клиента. В поле может быть введен как просто текст, так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TSelfDB с открытым набором данных со строчкой корреспонденции, заказа и клиента, на которую печатается чек

TBaseSupport

TBaseValue

Все объекты создаются с пустыми именами.

Так же система записывает в переменную $CashRegisterID вычисленный код фискального регистратора, на котором предполагается печать чека.

Результат работы скрипта печатается на создаваемом чеке, если скрипт не возвращает значение “-1” (число или текст) – в этом случае система чек не создает. Подразумевается, что либо скриптом было принято решение об отсутствии необходимости формирования чека, либо скрипт взял эту функцию на себя.

==== Заполнение шаблонов печатных форм ====

==== Дополнительные возможности ====

==== Импорт БД из Excel ====
В окружении интерпретатора создается объект ZakazRecord, он является списком со значениями таблицы zakaz. Именно в этот заказ будут загружены данные. Из этого объекта также доступно : 
*ZakazRecord.userfields - пользовательские поля заказа;
*ZakazRecord.Clients - данные таблицы clients;
*ZakazRecord.Clients.userfields - пользовательские поля заказчика.

==== Прайс лист клиента ====

Формула возвращает сумму в валюте клиента для каждой поездки (туда или обратно) единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Помимо стандартных объектов, система создает объект AddressRecord, в котором, как свойства, доступны все поля текущей записи. Так же она выставляет значение переменной $Forward в 1 (истина), если необходимо произвести расчет для направления "Туда" и 0 (ложь) - если обратно. ВНИМАНИЕ! Как и во всех остальных местах, после формулы нельзя ставить ";", иначе скрипт вернет 0!

Например:

if(int(AddressRecord.Time_Put_Max)>19, 100, 0)

''Прибавляет 100 рублей в случае, если максимальный срок доставки 20 часов или более''

if(pos(AddressRecord.Address, 'Аренда')>0,
set($FormulaReplace, 1);
1500
, 0)

''В случае наличия подстроки "Аренда" в адресе заменяет штатное ценообразование на 1500 рублей''

Объект AddressRecord может предоставить доступ к связанным таблицам :
* addressrecord.boxes
* addressrecord.packages
* addressrecord.clients
* addressrecord.price
* addressrecord.advprice
* addressrecord.userfields
* addressrecord.addressfld
* addressrecord.clients.userfields
* addressrecord.price.userfields
* addressrecord.zakaz
* addressrecord.zakaz.userfields

Чтобы получить доступ к полю VarCode из таблицы userfields необходимо записать AddressRecord.Userfields.VarCode. В присоединённой таблице может быть несколько записей чтобы получить к ним доступ предусмотрены функции _First, _EOF, _Next, _RecordCount, _Set.

Пример:
set($value1, 0); set($value2, 0);
while(AddressRecord.userfields._EOF=0,
if(AddressRecord.userfields.varCode=1,
set($value1, if(AddressRecord.userFields.VarValue='Праздничная упаковка', 150, 0)), ''''''');
if(AddressRecord.userfields.varCode=2,
set($value2, AddressRecord.userFields.VarValue), ''''''');
AddressRecord.userFields._Next;
);
int($value1) + int($value2)

Пример делающий тоже самое что и выше но через поиск Locate:
set($value1, if(addressrecord.userfields.VarValue('VarCode', 1)='Праздничная упаковка', 150, 0));
set($value2, int(addressrecord.userfields.VarValue('VarCode', 2)));
$value1 + $value2

В скрипте доступны переменные:
«$FormulaKoeff» - это коэффициент на который умножится конечная цена (по умолчанию равна 1);
«$PriceCode» - код прайса;
«$CurrentPriceConf» - код услуги;
«$BasePrice» - стоимость всех услуг с уровнем (pricelevel) меньше текущего.

Для вызова функции CalcBasePrice (Расчёт базовой цены) в скрипте объявленны переменные: $Count,$Collection,$Distance,$Wait.

Существует поиск по ключевому полю (поиск регистронезависимый), например чтобы найти в таблице advprice введённое значение для текущей услуги, нужно сделать такую запись addressrecord.advprice.value('priceconf', $CurrentPriceConf) - Первый параметр это ключевое поле, второй искомое значение. Если запись найдётся будет возвращено значение поле value, если нет функция вернёт значение 0.

Пример
if(addressrecord.advprice.active('priceconf', 3)='T', addressrecord.advprice.price, 0)

''Смотрим включена ли услуга и если да, возвращаем рассчитанную стоимость

Чтобы изменить значение записанное в объект addressrecord, нужно воспользоваться методом _set(keyfield, keyvalue, filed, value). Параметр keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Сначала происходит поиск строки по ключу, далее меняется значение указанного столбца.
Пример, отключение услуги база:
addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

Также существует упрощенный метод _set, с двумя параметрами filed, value - он используется в шаблонах загрузки или в системных доп. возможностях где доступен объект addressrecord.

==== Зарплата курьеров ====

Формула возвращает сумму в основной валюте для каждой единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Переменные «$FormulaTablKoeff» и «$FormulaMoneyKoeff» позволяют установить повышающий или понижающий коэффициент на стоимость доставки (по тарифной сетке) и услуги соответственно (процент от суммы, процент от стоимости доставки, ожидание). Переменная «$UsingZoneName» и «$KurierZone» содержат название и код зоны соответственно, есть возможность поменять название зоны для отчета.

=== Планировщик ===

В поле текста задания может быть введен как текст с командами планировщика (см ниже), так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TIniFile, Указывает на настроечный ini-файл планировщика.

Все объекты создаются с пустыми именами.

Для записи в лог планировщика нужно использовать функцию Print

=== Репликатор ===

== Прочее ==
ReplaceAddress(target, address) – Возвращает адрес последней доставки корреспонденции получателю target по адресу address от текущего клиента. При отсутствии такой доставки, возвращает address.

GetPrice –возвращает рассчитанное значение цены, на основе прайс-листа клиента и данных о корреспонденции.

GetKurierByStation(i) – возвращает код курьера, ассоциированного со станцией метро с кодом i.

GetNewNumber – Возвращает не занятый номер единицы корреспонденции в текущем заказе.

==История изменений==

=== Недавние изменения ===
{|
||'''Изменено:'''
|2026.0.0.550 Доработка функций интерпретатора GetA4Printer, GetStickerPrinter, GetDuplexPrinter.
|-
||'''Изменено:'''
|2026.0.0.547 Доработка функций ATTACHPDFTOTEXT и PRINTATTACHPDFPAGE, добавлена возможность указать путь к файлу
|-
||'''Добавлено:'''
|2025.0.0.539 Добавлена поддержка отладчика AttachDebugger
|-
||'''Добавлено:'''
|2025.0.0.534 Добавлена поддержка оператора CASE и класса TFunc
|-
|}

=== Версия 2021.0.0.57 от 18.06.2019 ===
{|
||'''Добавлено:'''
|В объект TExcel добавлен метод ColumnDelete.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция InsertFirmAtt.
|-
||'''Добавлено:'''
||В объект TExcel добавлен метод Align.
|-
||'''Добавлено:'''
|Функция CheckEan
|-
||'''Добавлено:'''
|В объект функцию FillAdvPriceReport добавлены параметры ShowSumPrice,InsertColumns
|-
||'''Добавлено:'''
|В объект TSMS добавлен метод Log.
|-
||'''Добавлено:'''
|Добавлена функция Money.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция ValutaSign.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция GetPolygonByLatLon.
|-
||'''Добавлено:'''
|В объект TTable добавлена функция SetMultiHeader, SetCustomHeader.
|-
||'''Добавлено:'''
|Функция DownloadAttachment
|-
||'''Добавлено:'''
|В функцию SetRowHeight объекта TExcel добавлен параметр cnt.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция AsString.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция SetSize.
|-
||'''Добавлено:'''
|В объект TADO добавлена функция ParseForIn.
|-
||'''Изменено:'''
|В объект TBaseUtils из TBase перенесена функция FillExcelDoc.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция CalcAddressPrice
|-
||'''Изменено:'''
|Все функции класса TBaseSupport перенесены в TBaseUtils. Класс TBaseSupport больше не существует.
|-
||'''Добавлено:'''
|В функции RowInsert и RowDelete объекта TExcel добавлен параметр count.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция SendToMeaSoft
|-
||'''Добавлено:'''
|В объект TBaseUtils функция RecalcSpecialSMA
|-
||'''Добавлено:'''
|Новая функция Reverse
|}

=== Версия 849   22.02.2018 ===

{|
||'''Добавлено:'''
|В функцию TBaseUtils.TownByIndex добавлен параметр PriorityName
|-
||'''Добавлено:'''
|В объекте TBase добавлена функция GetNewPackagePos
|-
||'''Добавлено:'''
|В объекте TSMS доработан метод ExtraResult, добавлен параметр ParamName
|-
||'''Добавлено:'''
|В объект TBase добавлена функция CalcAgentPrice
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateAddressForActDelivery
|-
||'''Изменено:'''
|Функция CalcTownDeliveryDate заменена на CalcDeliveryDate
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateSpecialSMA
|-
||'''Добавлено:'''
|Функция SignatureUrl
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция LoadFromStr.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetPen.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetBrush.
|-
||'''Добавлено:'''
|В объект TPicture добавлена поддержка чтения в формате PNG.
|-
||'''Добавлено:'''
|В функцию TCanvas.DrawPic параметр Mode
|-
||'''Добавлено:'''
|Свойство TPicture.Canvas
|-
||'''Добавлено:'''
|Функция DeleteFile
|}

=== Версия 758   29.03.2017 ===
{|
||'''Добавлено:'''
|Функция GetPolygonByAddress
|-
||'''Добавлено:'''
|Функция ParamsCount
|-
||'''Добавлено:'''
|Объект TZip
|-
||'''Изменено:'''
|Функции CreateEAN и Create128 заменены одной функцией CreateBar, полностью совместимой с Create128, но добавлена поддержка EAN-13 и Interleaved 2-5 (для Почты России). В системе функции оставлены для обратной совместимости, но более не являются документированными и рекомендованными к использованию.
|-
||'''Добавлено:'''
|Параметр text в функцию Cell объекта TExcel
|-
||'''Добавлено:'''
|Функция UrlEncode
|-
||'''Добавлено:'''
|Функция IncDay теперь может принимать параметр count
|-
||'''Добавлено:'''
|Функции FtpGet, FtpPut, TTable.SetCell()
|}

=== Версия 452   26.02.2014 ===

{|
||'''Добавлено:'''
|Функция Time
|-
||'''Добавлено:'''
|Функция FixedIntToStr
|-
||'''Добавлено:'''
|Функция TimePeriod
|-
|'''Добавлено:'''
|В интерпретатор добавлена функция приёма смс - ReceiveSMS
|-
|'''Добавлено:'''
|Функция STR2UTF
|-
|'''Добавлено:'''
|Функция SAVETOFILE
|-
|'''Добавлено:'''
|Функция TExcel.SetSheetName
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "FILESTR"
|-
|'''Добавлено:'''
|Расширены возможности объекта addressrecord в формулах тарифов
|}

=== Версия 308   24.11.2012 ===

{|
|'''Добавлено:'''
|В функции загрузки таблиц из TADO добавлено условие, что поля, названия которых начинаются с "-" не выгружаются. Таким образом можно скрывать служебные поля из результирующего набора.
|-
|'''Добавлено:'''
|Функция TExcel.RowAutoFit
|-
|'''Добавлено:'''
|Функция TExcel.RowInsert
|}

=== Версия 300   01.11.2012 ===

{|
|'''Добавлено:'''
|В объекте TCSVFile добавилась возможность запрашивать значения не только текущей записи через параметр сдвига
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "UPDOWN"
|-
|'''Добавлено:'''
|В интерпретатор добавлен объект TCSVFile
|}

=== Версия 266   14.09.2012 ===

{|
|'''Добавлено:'''
|В интерпретатор добавлена поддержка массивов
|}

=== Версия 265   11.09.2012 ===

{|
|'''Добавлено:'''
|Функция CreateTrans в интерпретатор
|-

Руководство программиста

2026-01-15T15:28:37Z

Sammy: /* Объект TBase */

== Основные положения ==

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

Как интерпретатор приводит типы:

1. При использовании значения как параметр функции интерпретатор автоматически приводит значение к типу, необходимому функции.

2. При операциях сложения, а также логических операциях, операнды приводятся к строке если хотя бы один из них имеет тип «строка». Например:
3.3+5 -> 8.3
‘3.3’+5 -> ‘3.35’
подобную проблему можно решить принудительно преобразовав тип:
float(‘3.3’)+5 -> 8.3

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

Как работают функции приведения типов:

1. При преобразовании строки к числу: функция «читает» строку до первого символа, не позволяющего создать число с плавающей точкой, при этом разделителем целой и дробной частей может быть как точка так и запятая. Если приведение производится к целочисленному типу, то после этого происходит округление. Например:
float('3.6qwerty735') -> 3.6
int('3.6qwerty735') -> 4

2. При преобразовании к булевому типу ложью считается пустая строка либо число 0, все остальное - истина

3. При преобразовании булевого типа к числу истина преобразуется в 1, ложь – в 0. Такое преобразование позволяет использовать сложение и умножение в качестве логических «ИЛИ» и «И» соответственно:
if((5=5)+(6=7), <a>, [b]) – условие истинно, выполнится код «a».

4. При преобразовании булевого типа к строке сначала происходит преобразование к числу:
(5=5)+'qwerty' -> ‘1qwerty’

== Описание синтаксиса ==

Команды разделяются точкой с запятой. Параметры функций разделяются запятыми. Каждая команда (даже цикл while) является функцией, возвращающей некоторое значение. Результатом выполнения составной команды (последовательности функций, разделенных точкой с запятой), является результат выполнения последней функции. Имена переменных, функций, объектов, а также их свойств и методов не чувствительны к регистру.
Константы: константы бывают целочисленными, дробными и строковыми. Значения целочисленных и дробных констант указываются «как есть» (в этом случае разделитель целой и дробной частей – точка), шестнадцатеричные значения начинаются с символа «$» и, если первая цифра – буква, она упреждается цифрой 0, а строковые – в одинарных кавычках. При этом, если внутри строковой константы встречается символ одинарной кавычки он должен быть задвоен, для указания интерпретатору того, что он не является признаком конца константы.
Операции сравнения: >, <, =, ! - Больше, меньше, равно, не равно соответственно.
Логические операции: + (ИЛИ), * (И).
Арифметические операции: +, -, *, /
Операция конкатенации строк: +

=== Функциональность базового объекта ===

'''SET($a, a)''' – присваивает переменной (1-й параметр) значение второго параметра. При отсутствии переменной – создает ее. Имена переменных должны начинаться с символа «$», а следующий символ не должен быть цифрой. Возвращает новое значение переменной. Функция используется только для задания значений переменных. Не допускается использования для задания значений свойств объектов. Для этого используются соответствующие методы этих объектов.

'''IF(a,b,c)''' или '''IF(a,b)''' – Условный оператор. В первом случае возвращает b, если a истинно (не равно нулю или пустой строке), иначе – c. Во втором случае – возвращает a, если оно истинно, иначе – b.

'''WHILE(a, b)''' – Оператор цикла. Выполняет b пока a истинно:
set($i, 10);
set($sum, 0);
while($i>0, set($sum, $sum+$i); set($i, $i-1));
$sum
Результат – 55

'''FOR($a, b, c, d)''' – Оператор цикла. Выполняет d пока $a последовательно присваиваются значения от b до с включительно:
set($sum, 0);
for($i, 1, 10, set($sum, $sum+$i));
$sum
Результат – 55

'''NEW(ClassName, InstanceName)''' – Создает экземпляр класса ClassName, назначает ему имя InstanceName. Возвращает порядковый номер созданного объекта. Доступ к свойствам и методам объектов осуществляется по имени объекта и имени свойства/метода, разделенным точкой. Именем объекта может быть и пустая строка, тогда доступ к его свойствам и методам будет осуществляться без указания имени, и, в случае совпадения имен свойств и/или методов со стандартными или свойствами/методами других объектов, использоваться будут соответствующие свойства/методы объекта, созданного ранее, а также такой объект невозможно уничтожить до окончания выполнения скрипта. Все объекты созданные во время выполнения скрипта уничтожаются автоматически после окончания его выполнения.

'''FREE(InstanceName)''' – Уничтожает объект с именем InstanceName. Возвращает 0. В случае отсутствия объекта с заданным именем вызывает ошибку.

'''ShowObjects''' – Возвращает список созданных объектов – названия классов и имена.

'''ERROR(message)''' – Вызывает ошибку с текстом message.

'''SHOWMESSAGE(message)''' – Отображает диалоговое окно с текстом message, останавливает выполнение скрипта до закрытия окна пользователем.

'''SimpleAskUser(Message)''' – Выводит диалоговое окно с текстом Message и кнопками «Да» и «Нет». Возвращает 1, если пользователь нажал кнопку «Да», иначе – 0.

'''TRY(a)''' – Выполняет a в «защищенном от ошибки» режиме. Если в процессе выполнения a возникает ошибка, возвращает текст ошибки, иначе – 0 (ложь).

'''REM(….)''' – Код в скобках игнорируется (комментарий).

'''EXEC(FileName, Params, Wait, WindowState)''' – Запускает внешнее приложение FileName с параметрами Params. Если Wait истинно – ожидает завершение процесса. Для WindowState доступны следующие числовые значения:
0 - SW_HIDE
1 - SW_SHOWNORMAL (по-умолчанию)
3 - SW_MAXIMIZE
6 - SW_MINIMIZE
Функция возвращает истину если приложение запущено успешно. Иначе – Ложь.
В случае успеха, при параметре Wait – истина кладет в переменную $LastResult код завершения приложения.

'''CASE''' - Оператор множественного выбора. Позволяет выполнить одно из нескольких действий в зависимости от условий. Синтаксис:
<source>
case(
when(условие1, действие1);
when(условие2, действие2);
...
else(действие_по_умолчанию);
);
</source>

Пример использования:
<source>

set($a, 10);
set($b, 50);

showmessage(
case(
when($a < 5, 50);
when($a < 10, 100);
when($a < 250, 200);
else($a*$b);
)
);
</source>

'''AttachDebugger''' - Команда позволяет подключить открытый [[Отладчик_встроенных_скриптов]] к текущему скрипту. Команда AttachDebugger должна быть '''первой командой''' в скрипте. Добавьте её в самое начало скрипта:

<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Как работает:'''
# При выполнении команды AttachDebugger скрипт останавливается.
# Отладчик автоматически подключается к выполняющемуся скрипту.
# Текст скрипта загружается в редактор отладчика.
# Можно ставить точки останова, просматривать переменные и продолжать отладку.

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Если режим отслеживания не включён, команда `AttachDebugger` игнорируется.
* В режиме отслеживания может работать только один отладчик.
* Команда AttachDebugger должна быть первой командой в скрипте.

=== Строковые функции ===

'''UpCase(s)''' – возвращает строку s в верхнем регистре.

'''LCase(s)''' – возвращает строку s в нижнем регистре.

'''Len(s)''' – возвращает количество символов в строке s.

'''Pos(s, substr [,start])''' – возвращает номер первого символа первого включения подстроки substr в строку s, возвращает 0, если включения подстроки отсутствуют. Параметр start - это позиция старта поиска, не обязательный параметр, по умолчанию равен 1. Поиск не чувствителен к регистру.

'''Param(s, i)''' – возвращает i-й элемент строки s, разделенной запятыми на элементы.

'''ParamsCount(s)''' - возвращает количество элементов строки s, разделенной запятыми на элементы.

'''SetParam(s, p, i)''' – заменяет на значение p i-й элемент строки s, разделенной запятыми на элементы.

'''Left(s, i [,full] )''' – возвращает i первых символов строки s. Параметр i, может быть строкой, тогда он считается разделителем и функция, возвращает строку слева от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Mid(s, i, j)''' - возвращает подстроку из s начиная с i символа и длиной j символов

'''Right(s, i [,full])''' – возвращает i последних символов строки s. Параметр i, может быть строкой, тогда он считается разделителем, функция ищет разделитель с конца строки, и возвращает строку справа от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Reverse(s)''' - возвращает строку s задом-наперед. Полезно например для поиска с конца функций Pos().

'''Char(i)''' – возвращает символ с кодом i.

'''Ord(s)''' – возвращает код первого символа строки s.

'''Replace(s, strFind1, strReplace1, [ strFind2, strReplace2, ... ], [caseInsensetive])''' - возвращает строку s, в которой все включения строк strFind заменены строкой strReplace. Параметры поиска и замены всегда должны быть в паре и их может быть несколько. caseInsensetive - неучитывать регистр, не обязательный параметр, по умолчанию включен.

'''RemSpace(s)''' – возвращает сроку s без начальных и конечных запятых и пробелов, а также начальных точек.

'''SumStr(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''с добавлением валюты'''. Необязательные параметры captions - позволяет изменить название валюты, формат строки может зависеть от текущего языка(посмотреть формат можно в "Справочники"-"Статусы"-"32 Валюты", в разделе "Дополнительная информация"). Language - код языка на котором необходимо вывести сумму прописью. По умолчанию если не обязательные параметры опущены, используются региональные настройки в переменных.

'''NumToStrSimple(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''без валюты'''. Параметры идентичны функции SUMSTR.

'''FullNameToShort(Name)''' – Возвращает фамилию и инициалы по полному ФИО Name.

'''MonthName1(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в именительном падеже.

'''MonthName2(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в родительном падеже.

'''StrForXML(s)''' - Подготавливает строку к парсингу как xml: Если находит в строке подстроку "UTF-8" - перекодирует ее из utf-8 в win-1251, убирает начальный знак вопроса, если такой встречается.

'''FixedIntToStr(i, len[, char])''' - Возвращает целое число i дополненное слева символами char (по-умолчанию - "0") до длины len.

'''Translate(format, [param1, param2, ...])''' - Функция перевода строки format в язык пользователя. Строка format может содержать параметры %s, %d - строка и число соответственно.

'''ExtractFileName(FilePath)''' - возвращает имя файла с расширением из полного пути к файлу FilePath.

====Функции перекодировки====
'''DecodeStr(s, charset)''' - Производит перекодировку строки s в кодировку CP1251. Кодировка строки s должна быть заранее известна и может быть :
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866, UNICODE. Имя кодировки следует передавать в точности без лишних символов.

'''EncodeStr(s, charset)''' - Производит перекодировку строки s в кодировку charset. Кодировка строки s должна быть CP1251, возможны следующие варианты перекодировки:
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Имя кодировки следует передавать в точности без лишних символов. UNICODE не работает с версии 2021, в ней строки по умолчанию в кодировке unicode.

Функции EncodeBase64(s), DecodeBase64(s), UrlEncode(s), UTF8Encode(s), UTF8Decode(s), Str2UTF(s) - устарели, используйте EncodeStr, DecodeStr.

====Транслитерация====

'''Translit(s)''' - транслитерация строки русского текста s латиницей

'''UnTranslit(s)''' - транслитерация строки s с латиницы на русский.

==== Экранирование ====

'''QUOTEDSTR(s)''' – квотирует строку s символом «\» (обратный слеш). Возвращает строку s, помещенную между символами одинарной кавычки, при этом все вхождения в строку s символов: «\», «"» и «'» экранируются квотирующим символом, а символы #0, #10 и #13 заменяются на \0, \n и \r соответственно.

'''SQLFloat(f)''' – Приводит число с плавающей точкой к виду, пригодному для SQL-запроса, т.е. к тексту с разделителем дробной части – точка.

'''FormatTextXML(s)''' - квотирует строку s для использования в XML. Производит замены спец. символов для корректности XML-синтаксиса.

'''FormatTextJSON(s)''' - переводит строку в формат JSON, экранирует служебные символы.

'''FormatTextBlob(s)''' - строка s содержит файл, функция перекодирует переданную строку в байты, используется для заполнения полей формата blob.

====Хеширование ====

'''HMACHash256(key, text)''' - создаёт хэш по алгоритму SHA256 для проверки целостности сообщения, key - секретный ключ, text - хэшируемое сообщение

'''MD5Hash(text)''' - создаёт хеш по алгоритму MD5

'''SignatureUrl(url)''' - Подписывает переданный URL. Функция возвратит переданный URL с добавленным в конце параметром, в котором будет записана подпись.

=== Функции работы с датой и временем ===

'''CurrTime''' – возвращает текущее время

'''CurrDate''' – возвращает текущую дату

'''CurrMillisecond''' - Возвращает количество миллисекунд прошедших с начала текущего года. Используется для точного расчета временных интервалов.

'''Today''' - возвращает текущую дату в числовом формате.

'''Day(dt)''' – возвращает день месяца даты dt.

'''Month(dt)''' – возвращает месяц года даты dt.

'''Year(dt)''' – возвращает год даты dt.

'''FirstDayOfMonth(dt)''' – Возвращает первый день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( FirstDayOfMonth( CurrDate() ) );
'''Полужирное начертание'''
'''LastDayOfMonth(dt)''' – Возвращает последний день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( LastDayOfMonth( CurrDate() ) );

'''DaysInMonth(month, year)''' – Возвращает количество дней в указанном месяце.

'''IncDay(dt, [count=1])''' – Возвращает дату, увеличенную на count дней.

'''SQLDate(dt)''' – Пытается конвертировать dt в дату, вернуть в формате «'YYYY-MM-DD'» (с апострофами), если не удается – возвращает «NULL».

'''SQLDateToDate(dt)''' – Переводит дату из SQL-формата в обычный.

'''DAYSBETWEEN(dt1, dt2)''' – Возвращает количество дней между датами dt1 и dt2. В случае ошибки приведения dt1 или dt2 к дате возвращает -1000.

'''TimeBetween(t1, t2)''' - Возвращает количество минут между временем t1 и t2. Если t1 > t2 то будет показано количество минут между t2 и t1. Параметр t может быть как в формате "HH:MM", так и в числовом. Если один из параметров не удалось привести к числовому типу возвращает -1000.

'''WorkDaysBetween(dt1, dt2, [DecreaseFirstDay=0], [DefaultHolidayVarNum=1])''' - Возвращает количество рабочих дней между датами dt1 и dt2. Параметр DecreaseFirstDay уменьшает dt1 на указанное количество дней (по умолчанию 0). В случае ошибки приведения dt1 или dt2 к дате возвращает -1000. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней(по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''TimePeriod(time1, time2)''' - Оформляет временной период. Возвращаемое значение зависит от наличия значения в параметрах. Возможные варианты: "time1 - time2" , "С time1" , "ДО time2".

'''StrDateToFloat(s, [time=false])''' - Переводит строку с датой s в числовой тип. Если параметр time включен, то в строке s должно быть указано время. Дата должна быть в формате "DD.MM.YYYY", а время "HH:NN". Если строку перевести не удалось возвращает 0

'''IsAWorkDay(dt)''' - Когда день dt является рабочим, возвращает true. Если произошла ошибка приведения даты возвращает -1000.

'''IncWorkDay(dt, [count=1],[DefaultHolidayVarNum=1])''' - Прибавляет count рабочих дней к дате dt. Возвращает дату в числовом формате, если произошла ошибка приведения даты возвращает -1000. По умолчанию параметр count равен 1 и не является обязательным. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней (по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''Sleep'''(n) - Задержка выполнения на n миллисекунд.

=== Функции приведения типов ===

'''INT(v)''' – возвращает значение типа “целое”, приводя вариантное значение v к числовому типу, а затем округляя его. В том числе используется как функция округления.

'''FLOAT(v)''' – возвращает значение типа “число”, приводя вариантное значение v к числовому типу, переводя в число цепочку символов до первого нецифрового символа (либо точки или запятой).

'''STR(v)''' – возвращает значение типа “строка”, приводя вариантное значение v к строковому типу.

'''Date(v)''' – возвращает дату, либо пустую строку, если не удается конвертировать v в дату

'''Time(v)''' – возвращает время, либо пустую строку, если не удается конвертировать v во время. Понимает числовое представление времени.

=== Математические функции ===

'''ROUNDUP(f)''' – округляет число f до ближайшего большего по модулю целого числа.

'''ROUNDDN(f)''' – округляет число f до ближайшего меньшего по модулю целого числа.

'''Money(f, CouldBeEmpty, ZeroFill, MakeSpace)''' - Округляет число f, до двух знаков после запятой. CouldBeEmpty - заменить число меньше 0,0001 на пустую строку. ZeroFill - Следить чтобы после запятой было два знака, если будет один, то добавить ноль. MakeSpace - Разделить разряды пробелом.
''Подсказка: для простого округления используется функция int()''

'''Abs(f)''' - возвращает модуль числа f.

'''Mod(x, y)''' - возвращает остаток от деления целочисленного числа x на целочисленное число y.

=== Константы ===

'''Null''' – Возвращает пустое значение.

'''Да''', '''True''', '''Нет''', '''False''' – константы, соответствующие булевым значениям.

=== Прочие функции ===

SetPhoneParams(CountryCode, TownCode) – Устанавливает глобальные настройки кода телефонных кодов страны и города соответственно. По-умолчанию код страны – 7, код города – 495.

PhonesCount(s) – Возвращает количество корректных телефонных номеров, найденных в строке s.

GetPhone(s[, n]) – Возвращает n-й корректный телефонный номер, найденный в строке s. Нумерация начинается с 1.

GetEmail(s) – Возвращает все корректные адреса email, найденный в строке s, разделенные запятыми (т.е. готовыми к передаче в функцию SendEmail).

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

GenEan(ID, Code) – Формирует штрих-код EAN 13 Состоящий из идентификатора типа сущности ID и кода сущности Code, Выравнивает до 13-ти символов, первый – «2», последний – контрольная сума.

CheckEan(s) - Проверяет строку s, что она является кодом EAN13.

SaveToFile(FileName,s, encoding [, append])- Создает текстовый файл по пути, указанному в FileName (если по указанному пути существует файл с указанным именем, он удаляется и создается новый) и производит запись строки s в созданный текстовый файл. encoding - название кодировки, по умолчанию сохраняет в кодировке ANSI. Доступные названия кодировок: KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Если append = true, то производится дописывание данных в файл, а не перезаписывание (не обязательный, по умолчанию выключен).

StrFromFile(FileName) - Читает файл FileName, возвращает в виде строки. При ошибке чтения вызывает ошибку.

DownloadAttachment(code, [savefilepath, tablename='attachment', fieldBlob='file', fieldLDtime='ldtime', fieldUID='uid']) - Функция выкачивает аттачмент из базы, по внутреннему коду - Code, всегда возвращает содержимое файла в виде строки, а также может сохранить файл по указанному пути в параметре savefilepath. По умолчанию, функция настроена на таблицу attachment. Code - внутренний код вложения, tablename - название таблицы, fieldBlob - название поля с содержимым файла, fieldLDtime - название поля с временем последнего изменения строки (для работы кэша). Функция использует кэш и умеет выкачивать файлы зауженные на внешние серверы (http, ftp,sftp, measoft). Для выкачивания с сервера measoft обязательно необходимо указывать параметр fieldUID.

DeleteFile(FileName) - Удаляет файл FileName с диска, возвращает истину, если операция прошла успешно и ложь - в противном случае.

HTTPPOST(host, PostParams, Proxy, ContentType, HTTPUser, HTTPPass, Method, CustomHeader, Reconnects) - Отправляет HTTP запрос по адресу host с данными PostParams. Proxy - объект Proxy, задающий прокси-сервер (по-умолчанию - пусто - не использовать прокси). ContentType - Заголовок ContentType. По-умолчанию - "application/x-www-form-urlencoded; Charset=UTF-8". HTTPUser и HTTPPass - данные для http-авторизации на сервере. Method - метод отправки запроса, по-умолчанию - "POST". CustomHeader - Дополнительные заголовки HTTP запроса, передается в виде списка параметров через запятую и всегда образуют пару: 1 параметр - название заголовка, 2 параметр - значение. Если значение содержит запятую то его нужно экранировать в двойные кавычки. Reconnects - Количество попыток подключения (по-умолчанию - 2), если больше 100 - это таймаут единственной попытки подключения в миллисекундах.
Функция возвращает ответ сервера. 
''Обратите внимание:'' Для имитации отправки данных html-формы методом POST может понадобиться перед передаваемыми параметрами добавить "Data=".

FTPPUT(host, User, Pass, FileName[, Active]) - Отправляет файл на FTP/SFTP-сервер. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

FTPGET(host, User, Pass, SourceFileName, DestFileName[, Active]) - Загружает файл SourceFileName с FTP/SFTP-сервера, сохраняет его в файл DestFileName. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

GetTempDir - Возвращает путь к временной папке.

ApplicationDir - Возвращает путь к файлу программы.

Interpretate(script) - Интерпретирует скрипт указанный в script. Выполнение происходит в текущем инстансе.

LastHttpError - Выводит последний запрос выполненный с ошибкой в функции HttpPost. Содержит подробную информацию по запросу и ответу.

LastHttpResponse - Выводит последний запрос и ответ от сервера после выполнения Http-запроса в функции HttpPost.

== Объект TExcel ==

Предназначен для доступа к данным документов MS Excel. Требует установленного приложения MS Excel. Для работы без установленного MS Excel предусмотрен объект TDirectExcel.

'''''Ввод данных'''''

LoadFromDB(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Если Headered истинно (по-умолчанию), таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Если TranslateHeader истинно, то заголовки таблицы будут автоматически переведены.

MyDB.Open('select * from kurier');
xl.LoadFromDB(MyDB.Self);
xl.DoNotDestroy(true);
xl.SetVisible(true);

Post2Sheet(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) - Почти полный аналог LoadFromDB. В отличии от LoadFromDB если есть открытый файл, выгрузка данных будет выполнена прямо в него.

OpenFile(aFileName) – Выполняет функции SetFileName и Open.

FileName – Возвращает имя текущего файла.

SetFileName(aFileName) – Задает значение свойства FileName.

Open - Открывает файл с именем, заданным свойством FileName. Если имя файла не задано - создает чистую книгу.

Close – Закрывает текущий файл.

'''''Ячейки'''''

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

Cell(x, y, text) – Возвращает значение ячейки, заданной координатами x, y. Необязательный булевый параметр text, в случае истинности, указывает на необходимость возврата данных с учетом формата ячейки, т.е. то, что пользователь видит на экране. Обратите внимание, что если в ячейке число, и ширина столбца не достаточна для отображения, Excel выводит "#####", что и будет возвращено программе, если text=ИСТИНА. Поэтому перед таким использованием рекомендуется выполнить функцию AutoFit.

SetCell(x, y, v[, x2, y2]) – Устанавливает значение ячейки, заданной координатами x и y, в значение v. Если заданы параметры x2, y2 - объединяет (merge) диапазон ячеек заданных координатами, устанавливает значение объединенной ячейки.

'''''Строки'''''

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

RowAutoFit([y1, y2]) - Устанавливает автоматическую высоту строк. Аргументы y1 и y2 необязательны и если не указаны, то процедура будет выполнена для всей страницы, в ином случае только для строк от y1 до y2.

SetRowHeight(r, h[, cnt]) – Устанавливает высоту cnt строк (по-умолчанию 1) начиная со строки r в h пикселей.

GetRowHeight(r) – Возвращает высоту строки r в пикселях.

RowInsert(i[, count]) - Вставляет count (по-умолчанию - 1) строк НАД строкой с номером i.

RowDelete(i[, count]) - Удаляет count (по-умолчанию - 1) строк начиная с номера i.

'''''Столбцы'''''

ColCount - Возвращает количество столбцов в листе.

AutoFit – Устанавливает автоматическую ширину столбцов.

ColumnDelete(i[, count]) - Удаляет count (по-умолчанию - 1) столбцов начиная с номера i.

SetColWidth (c, w) – Устанавливает ширину столбца c в w пикселей.

GetColWidth (c) – Возвращает ширину столбца c в пикселях.

'''''Листы'''''

SetSheet(No) – Устанавливает номер текущего листа. Если лист с таким номером не существует - он будет создан (и все листы до него). Нумерация начинается с 1.

SetSheetName(Name) - Устанавливает название текущего листа.

SheetsCount – Возвращает количество листов в книге.

CopySheetAfter([SheetFrom[, SheetAfter]]) - Копирует лист SheetFrom (по-умолчанию - текущий), создавая новый лист после листа SheetAfter (по-умолчанию - совпадает с копируемым).

SheetDelete(i) - Удаляет лист с номером i.

'''''Форматирование'''''

Align(x1, y1, x2, y2 [,HAlign, VAlign]) - Устанавливает выравнивание данных в указанном диапазоне. HAlign - горизонтальное выравнивание (0 – прижато влево , 1 – по центру , 2 – прижато вправо), VAlign - Вертикальное выравнивание (0 – прижато к верху , 1 – по центру , 2 – прижато к низу).

WrapText(x1, y1, x2, y2, value) – Устанавливает перенос текста прямоугольника в значение value. Если координаты опущены, или 0 – устанавливает границы всей используемой области. Для Value значение по-умолчанию - true.

NumberFormat(x1, y1, x2, y2, Format) - Устанавливает формат вывода чисел в указанном диапазоне ячеек. Например, если Format='0.00' - числа будут выводиться c обязательными 2 знаками после десятичного разделителя.

SetBorders(x1, y1, x2, y2) – Устанавливает границы прямоугольника. Если координаты опущены, или 0 – устанавливает границы всей используемой области.

SetFont(Font[, x1, y1[, x2, y2]]) - Устанавливает шрифт Font для ячеек диапазона. Можно указать координаты только одной ячейки, можно - вообще не указать, тогда будет использован последний выделенный диапазон. Шрифт задается как обычно: 'Arial, 16, T, T, T', порядок параметров: Имя шрифта, размер, жирное начертание, курсивное начертание, одиночное подчеркивание. Если параметры не заданы, то у текущего шрифта они меняться не будут. Примеры: SetFont('Arial, 10, T, F, F', 1,1) - в ячейке A1 будет установлен шрифт Arial жирным начертанием (не курсив и без подчеркивания). SetFont(', , , T, F', 2,1) - в ячейке B1 будет поменяется только начертание курсив и будет отменено подчеркивание (если оно было).

SaveValuesOnly - убирает формулы на текущей странице и оставляет лишь их результативные статичные значения.

'''''Цвета'''''

SetRowFontColor(Row,Color) - Устанавливает цвет шрифта в строке Row. Color - целое значение (RGB)

SetRowColor(Row,Color) - Устанавливает цвет фона в строке Row. Color - целое значение (RGB)

SetColumnFontColor(Col,Color) - Устанавливает цвет шрифта в столбце Col. Color - целое значение (RGB)

SetColumnColor(Col,Color) - Устанавливает цвет фона в столбце Col. Color - целое значение (RGB)

SetCellFontColor(Row,Col,Color) - Устанавливает цвет шрифта в ячейке с координатами [Row,Col]. Color - целое значение, равное номеру цвета в палитре (ColorIndex,не RGB)

SetCellColor(Row,Col,Color) - Устанавливает цвет фона в ячейке с координатами [Row,Col]. Color - целое значение (RGB)

GetRowFontColor(Row)- Возвращает RGB значение цвета шрифта строки Row

GetRowColor(Row)- Возвращает RGB значение цвета фона строки Row

GetColumnFontColor(Col)- Возвращает RGB значение цвета шрифта столбца Col

GetColumnColor(Col)- Возвращает RGB значение цвета фона столбца Col

GetCellFontColor(Row,Col) - Возвращает номер цвета шрифта в палитре (ColorIndex) в ячейке с координатами [Row,Col]

GetCellColor(Row,Col) - Возвращает RGB значение цвета фона в ячейке с координатами [Row,Col]

'''''Копи-паст'''''

Copy(x1, y1, x2, y2) - Копирует в буфер экселя

Cut(x1, y1, x2, y2) - Вырезает в буфер экселя

Paste(x1, y1) - Вставляет из буфера экселя. Команды copy-paste неразрывны, если что нибудь сделать в промежутке между ними, например вставить значение в ячейку, то копирование сброситься. (Последовательность использования: copy - paste, cut - paste)

PasteStyle(x1, x2, y1, y2) - Вставляет только оформление из буфера экселя (Последовательность использования: Copy - PasteStyle)

'''''Изображения'''''

InsertPicture(TPicture, [x=1, y=1, DispX=0, DispY=0, width=0, height=0]) - Функция вставляет рисунок на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки, width, height (не работает для DirectExcel) - ширина и высота области рисунка в пойнтах-единицах Excel

InsertFirmLogo(FirmCode, [x=1, y=1, DispX=0, DispY=0]) - Функция вставляет логотип фирмы с кодом FirmCode на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки.

'''''Вывод'''''

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки. Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SheetFitPageWidth - устанавливает режим масштабирования печати, чтобы печатная форма помещалась в ширину на один лист.

SetOrientation(value) - Устанавливает ориентацию страницы. True (по-умолчанию) - альбомная (ландшафтная), Ложь - портретная.

PrintOut([copies]) - Печатает текущий лист на принтере по умолчанию. Параметр copies - количество копий, по умолчанию равен 1.

Save(filename) - Сохраняет в файл filename. Если файл существует, в основной системе он будет перезаписан, в других проектах - вызовет ошибку "Файл уже существует".

SetVisible(b) – Устанавливает видимость приложения Excel для пользователя. По-умолчанию – false (не видимо).

DoNotDestroy(b) – При уничтожении объекта TExcel (а он уничтожается, как и все остальные объекты автоматически при завершении выполнения скрипта), приложение Excel уничтожается вместе с ним. DoNotDestroy(true) отключает уничтожение приложения.

'''''Пример использования'''''

new('TExcel', 'myxl');
myxl.OpenFile('c:\asdf.xlsx');
set($sum, 0);
while (myxl.EOF=0,
set($sum, $sum+int(myxl.c));
myxl.next );
$sum

''Возвращает сумму всех числовых данных столбца C файла 'c:\asdf.xlsx'''

== Объект TDirectExcel ==
Объект позволяет работать с файлами Excel напрямую, без установленного пакета MsOffice. Применяется в сервисах и при отсутствии экселя. Он максимально совместим с объектом TExcel, однако некоторые методы могут быть не реализованы.

== Объект TCSVFile ==
Предназначен для доступа к данным документов CSV. Разделителем столбцов является символ точка с запятой ;

Функции:

FileName – Возвращает имя текущего файла.

OpenFile(FileName) – Открывает файл FileName.

LoadFromDB(DB[, Headered=false]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO.

LoadFromText(s) - Загружает таблицу из строки s.

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки.

SaveToFile(Filename) - Сохраняет в файл с именем filename.

== Объект TADO ==

Предназначен для доступа к базам данных.

Функции:
{| class="wikitable"
!Функция
!Описание
|-
|Connect(ConnectionString)
|Подключает к источнику данных. ConnectionString – Строка подключения ADO.
|-
|ConnectMySQL(DBServer, DBPort, DBUser, DBPass, DBName)
|Подключает к базе данных MySQL.
|-
|Open(Query)
|Открывает набор данных выполнив запрос Query.
|-
|FieldByNo(i)
|Возвращает значение поля с номером i. Нумерация полей – с нуля.
|-
|FieldName(i)
|Возвращает имя поля с номером i.
|-
|FieldCount
|Возвращает количество полей.
|-
|RecordCount
|Возвращает количество записей.
|-
|RecNo
|Возвращает номер текущей записи. ''ВНИМАНИЕ! В зависимости от способа подключения к БД нумерация может начинаться как с 0 так и с 1!''
|-
|EOF
|Возвращает признак достижения конца набора данных. Становится истиной когда выполняется команда Next на последней записи.
|-
|Next
|Переход на следующую запись набора.
|-
|First
|Переход на первую запись набора.
|-
|Last
|Переход на последнюю запись набора.
|-
|FieldByName(FieldName)
|Возвращает значение поля по имени. Также возможно указание имени поля как свойства объекта.
|-
|Field(Table, ID, FieldName)
|Возвращает значение поля FieldName записи с кодом ID таблицы Table. Набор данных, если он открыт, при этом не закрывается. Первичный ключ таблицы должен называться «code». Гарантированно работает только с MYSQL!!!
|-
|GetSQLValue(Query)
|Выполняет SQL-запрос. Текст запроса должен начинаться с первого символа строки (перед запросом не должно быть пробелов, переносов строк, комментариев и т.д.). Если запрос Insert – возвращает ID вставленной записи. Если запрос – Update, Delete, Replace, Set, Start, Commit, Rollback – возвращает количество измененных записей (RowsAffected), иначе – Select – значение первого поля первой строки результата как текст.
|-
|FillText(s)
|Возвращает строку s с замененными названиями полей между знаками процента на соответствующие значения текущей записи. Так же в строке возможно использование интерпретируемого кода, заключенного между тегами "<?>" и ">". При интерпретации система сначала производит замену полей с процентами на значения, потом интерпретирует код. ''Внимание! Функция не создает отельный контекст интерпретатора, а использует существующий, в нем доступны все объекты и переменные, вызывающего скрипта.'' Дополнительно автоматически создается объект TSelfADO, подключенный к той же БД, что и контекст, вызвавший функцию, с пустым именем, а так же с именем "dataset".
|-
|Query(Query)
|Синоним GetSQLValue.
|-
|Close
|Закрывает набор данных.
|-
|Self
|Возвращает указатель на подключение к БД для использования в других объектах.
|-
|ParseForIn([FieldName='code'])
|Возвращает через запятую значения всех строк в указанном столбце. По умолчанию, используется столбец с именем code.
|-
|GetSQL
|Для отладки. Возвращает последний SQL запрос переданный в методы Open, Query, GetSQLValue
|-
|ExportExcel
|Для отладки. Выгружает в эксель содержимое датасета. Можно использовать в незнакомом окружении для понимания передаваемых полей в : шаблонах, печатных формах и т.д. Аналог команды %echo% в шаблонах, на случай если она не сработает.
|-
|OnGetText
|Функция подменяет текстовый вывод значения поля при выгрузке в эксель. Первый параметр это имя поля, которое надо подменить. Второй параметр это то что необходимо вывести. Работает только с текстовыми полями.
'''''Пример использования'''''
DB.OnGetText('Зона', IF((DB.FieldByName('-Lat') ! 0) * (DB.FieldByName('-Lon') ! 0),
GetPolygonByLatLon(DB.FieldByName('-Lat'), DB.FieldByName('-Lon'), 'TYPE = 1 AND IFNULL(zone, 0) > 0 AND PRICE = ' + DB.FieldByName('-price'), 'zone')
,
''
));
|}

Пример использования – см. TSelfADO

== Объект TSelfADO ==

Наследник объекта TADO. Служит для подключения к «родной» для программы, в которой выполняется скрипт, базе данных. Обладает всеми свойствами и методами объекта TADO, кроме Connect. Иногда автоматически создается системой для обеспечения простого доступа к базе данных, а также иногда создается системой с уже открытым набором данных для передачи обрабатываемого системой набора данных в скрипт. В этом случае для скрипта недоступны функции Open и Close.

Пример использования:

rem('Копируем данные из "родной" базы данных в базу MSSQL.');
new('TSelfADO', 'MyDB');
new('TADO', 'MSSQL');
MSSQL.Connect('Provider=SQLOLEDB.1;Password=myPassword;Persist Security Info=True;User ID=myUsername;Initial Catalog=myDataBase;Data Source=myServerAddress');
MyDB.Open('select code, name, passport from kurier where code>'+Int(MSSQL.Query('select max(code) from kurier'))+' order by code');
While(MyDB.EOF=0,
MSSQL.Query('insert kurier (code, name, passport) VALUES ('+MyDB.Code+', '+QuotedStr(MyDB.Name)+', '+QuotedStr(MyDB.Passport)+')');
MyDB.Next;
);

== Объект TPrinter ==

Предназначен для доступа к принтерам.

Функции:

BeginDoc – Начинает новый документ.

EndDoc – Закрывает документ

PageHeight – Возвращает высоту страницы в пикселях

PageWidth – Возвращает ширину страницы в пикселях

PageNumber – Возвращает номер текущей страницы документа

Orientation – Возвращает текущую ориентацию страницы (0 – портретная, 1 – ландшафтная)

Printing – Возвращает истину если документ открыт

SetOrientation(Orientation) – Устанавливает ориентацию страницы. При необходимости начинает новый документ, новую страницу.

ShowDialog – Показывает пользовательский диалог печати. Возвращает истину, если пользователь нажал "OK".

NewPage – Начинает новую страницу

Canvas – Предоставляет доступ к объекту TCanvas, связанному с принтером.

PrinterNames – Возвращает список принтеров, установленных в системе, разделенный переносами строк

PrintersCount – Возвращает количество установленных в системе принтеров

SetPrinter(Printer) – Устанавливает текущий принтер. Если передана строка – ищет принтер по названию, иначе – по номеру. Нумерация начинается с 0.

PrintTable(Y, Table) – Выводит на печать таблицу Table типа TTable, начиная с координаты Y. При необходимости таблица печатается на нескольких страницах. Возвращает координату Y конца таблицы.

GetDefaultPrinter - Возвращает имя текущего активного принтера.

SetDefaultPrinter(Printer) – Запоминает предыдущий активный принтер и устанавливает новый текущий принтер. Printer - имя принтера. При необходимости нескольких последовательных вызовов SetDefaultPrinter рекомендуется между вызовами использовать RestoreDefaultPrinter.

RestoreDefaultPrinter - Устанавливает активным принтер, который был текущим перед последним вызовом SetDefaultPrinter.

== Объект TCanvas ==

Предоставляет доступ к холсту объекта для прорисовки изображения.

Функции:

DPIX – Возвращает разрешение холста по горизонтали в точках на дюйм

DPIY – Возвращает разрешение холста по вертикали в точках на дюйм

TextOut(x, y, s[, x1, y1, x2, y2]) – Выводит строку s начиная с точки с координатами x и y. Если указаны параметры x1, y1, x2, y2 – то выводимый текст ограничивается заданным прямоугольником.

TextOutEx(x1, y1, x2, y2, Alignment, Font, s, Indent) – Выводит строку s в прямоугольнике с координатами x1, y1, x2, y2. По горизонтали строка выравнивается в соответствии с Alignment (0 – прижато влево, 1 – вправо, 2 – по центру), по вертикали выравнивается по центру. Используя шрифт Font (см описание ниже). Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату X фактического окончания текста (правой стороны – если строка прижата влево, и левой – в остальных случаях)

MLTextOut(x1, y1, x2, y2, Alignment, VAlignment, Font, s, Heigth, Indent) – Выводит многострочный текст s в прямоугольнике с координатами x1, y1, x2, y2 с переносом по словам. По горизонтали строки выравниваются в соответствии с Alignment, по вертикали – в соответствии с VAlignment (0 – прижато вверх, 1 – по центру, 2 – прижато вниз). Используя шрифт Font (см описание ниже). Heigth – высота строки. Если опущено или равно нулю – высота определяется автоматически в соответствии с выбранным шрифтом. Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату Y фактического окончания текста (нижней границы последней строки текста. ''ВНИМАНИЕ! Функция использует координаты прямоугольника для позиционирования текста, однако она не ограничивает его верхней и нижней границами этого прямоугольника!''

DrawPic(x1, y1, x2, y2, Pic, Style, Alignment, Mode) – Прорисовывает изображение Pic (ссылка на изображение TPicture.Self) в прямоугольник заданный координатами x1-y2. Style – стиль масштабирования. 0 – растянуть изображение до границ прямоугольника не сохраняя пропорции, 1 – вписать изображение в прямоугольник сохраняя пропорции – вероятно, останутся поля по вертикали или горизонтали, 2 – вписать сохраняя пропорции, обрезав при необходимости изображение по вертикали или горизонтали. Alignment – выравнивание по горизонтали. Работает только в случае если style=1 и при растягивании изображения получились вертикальные поля. 0 – разместить по центру, 1 – прижать влево, 2 – прижать вправо. Функция возвращает координату X правой стороны изображения кроме случая, когда Style=1 и Alignment=2 – в этом случае возвращается координата левой стороны изображения. Mode - способ наложения изображения. 0 (по-умолчанию) - копирование как есть. 1 - Наложение операцией AND (применяется для получения эффекта прозрачности изображения), 2 - наложение операцией XOR (Применяется для возможности повторной операцией убрать изображение), 3 - Наложение операцией OR.

FillRect(x1, y1, x2, y2) – Рисует прямоугольник '''без границ''' и закрашивает цветом BrashColor

Rect(x1, y1, x2, y2) – Рисует прямоугольник '''c границами''', задаваемыми текущим пером, и закрашивает цветом BrashColor

SetFont(Font) – Устанавливает шрифт по-умолчанию.

SetPen(Width, Color) - Устанавливает параметры "ручки" - толщину и цвет. Если любой параметр опустить, соответствующее значение не будет изменено.

SetBrush(Color, Style) - Устанавливает параметры заливки - цвет и стиль. Если любой параметр опустить, соответствующее значение не будет изменено. Стили заливки: 0 - сплошная, 1 - отсутствует (прозрачная), 2-7 - различные виды штриховки (горизонтальные, вертикальные, в клеточку и т.д.).

TextHeight(s) – Возвращает высоту текста s в пикселях без учета многострочности, с учетом текущего шрифта.

TextWidth(s) – Возвращает ширину текста s в пикселях без учета многострочности, с учетом текущего шрифта.

Использование шрифта (Font): У объекта TCanvas есть «глобальные» установки шрифта. Однако для некоторых функций возможно указание шрифта, отличающегося от глобального. Параметры шрифта – это текстовая строка, состоящая из 6-ти параметров, разделенных запятыми: Название, размер, жирный, курсив, подчеркнутый, цвет. Например:

'Times New Roman, 8, Y, N, N, 255'

Любой параметр можно опустить, и тогда вместо него будет использовано значение по-умолчанию: шрифт: arial, размер – 10, не жирный, не курсив, не подчеркнутый, цвет – черный. Например: ', 7' – указывает, что по-умолчанию нужно взять все параметры кроме размера шрифта. Также можно вместо всей строки указать тире ('-') или пустую строку, и шрифт будет использоваться «глобальный».

Объект можно создать отдельно, не создавая объект TPrinter. В таком случае объект создастся как ссылка на текущий холст принтера (принтер должен быть запущен и начат новый документ). Такой подход используется в доп. возможности PrintCustomSticker

== Объект TPicture ==

Предоставляет функции для работы с графическими изображениями форматов BMP, GIF, JPEG и PNG, а также для формирования штрих-кодов. Обратите внимание, прозрачность изображений не поддерживается, однако в методе TCanvas.DrawPic есть параметр Mode, призванный создавать эффект прозрачности.

Функции:

LoadFromFile(FileName) – Загружает изображение из файла FileName. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromDB(DB, Query) – Загружает изображение из базы данных. DB – ссылка на подключение к базе данных TADO.Self, Query – текст запроса. Запрос должен вернуть в первом поле первой строки BLOB-поле с изображением, все остальные данные возвращаемые запросом игнорируются. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromStr($s) – Загружает изображение из строки $s. Возвращает истину, если операция прошла успешно, иначе – ложь.

CreateBar(Width, Height, BarCode, Textless, Type) – Формирует штрих-код шириной Width и высотой Height с типом кодирования Type. BarCode – текст штрих-кода. Булево значение Textless указывает, что в штрих-коде не должно быть человеко-читаемых символов если истинно. Type указывает тип кодирования: 0 (по-умолчанию) CODE128, 1 - EAN-13, 2 - Interleaved 2-5, 3-DataMatrix, 4-QRCode.
Штрихкод должен быть: Для EAN-13 цифровым 12 или 13 символов (13-й, контрольная сумма рассчитывается автоматически), для CODE128 - должен иметь состоять из допустимого для этого кодирования набора символов. Для Interleaved - должен состоять из четного числа цифр, контрольная сумма автоматически не рассчитывается. Если для Interleaved кода указано значение из 14-ти знаков, подпись цифр выводится в формате Почты России.
Внимание! Для кодов EAN-13 и Interleaved ширина штрих-кода Width не является точным значением получаемого на выходе изображения. Ширина изображения рассчитывается как максимальное кратное минимально возможной ширине, но не меньше минимально возможной. Конечную ширину можно получить в соответствующем свойстве объекта. Для кода CODE128 штрих-код на выходе может оказаться пустым, если указанной ширины штрих-кода не достаточно для его формирования.
Для кода DataMatrix можно установить режим для печати скрытых символов с кодами 29(GS) и 232(FCN1), которые требуются для формирования Честного Знака. Для этого необходимо в начале строки указать символ "[" и все разделители 01, 21, 91, 92 так же экранировать этими скобками. Должно получиться [01]02900002317701[21]k3LInNbH_oG0Q[91]EE06[92]YXiyKfiHjE4YE8b+YVMC1O5r8VtpplA3AwcCqrcG9Dk= . При формировании кода, включится режим формирования штрих-кода DataMatrix GS1, в начале будет добавлен символ с кодом 232 (FCN1), а потом будут добавлены разделители с кодом 29 (GS)
Функция возвращает 1 в случае успеха, или текст ошибки, если такая произошла.

SetSize(Width, Height) - Устанавливает размер изображения.

AsString([ImageFormat]) - Возвращает изображение в виде строки с двоичными данными. ImageFormat принимает значения 1 - Bitmap (по-умолчанию), 2 - jpeg, 3 - png, 4 - gif.

Width – Возвращает ширину изображения.

Height – Возвращает высоту изображения.

Rotate(Angle) – Поворачивает изображение по часовой стрелке на угол Angle. Угол указывается в градусах и может принимать любые значения.

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

Canvas - ссылка на объект TCanvas холста изображения.

== Объект TTable ==

Предоставляет функции для работы с таблицами. Удобен для печати таблицы на принтере. Алгоритм таков: Загружаем датасет в таблицу, настраиваем ее (шрифты, штрих-коды и т.д.), потом выводим на принтер функцией TPrinter.PrintTable.

Функции:

LoadFromDB(DB) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Заголовок – это первая строка таблицы.

Cell(С, R) – Возвращает значение ячейки таблицы с координатами (C, R). Нумерация строк и столбцов начинается с 1.

SetCell(С, R, Value) – Устанавливает значение ячейки таблицы с координатами (C, R) в Value. Нумерация строк и столбцов начинается с 1.

RowCount – Возвращает количество строк в таблице.

ColCount – Возвращает количество столбцов в таблице.

SetTitleFont(Font) – Задает шрифт заголовка таблицы (первой строки).

SetFont(Font) – Задает шрифт всей таблицы кроме заголовка.

SetColFont(C, Font) - Устанавливает шрифт столбца C.

SetIndent(Indent) – Задает отступ от границы ячейки до текста в процентах от ширины страницы. По-умолчанию значение 0.3

SetWidth(С, Width) – Задает значение ширины столбца C в процентах от ширины страницы.

SetMinRowHeght (Heght) – Задает значение минимальной высоты строки в пикселях.

SetBarCode(Col, Type) - Указывает, что данные из столбца Col должны печататься в виде штрих-кода. Тип штрих-кода - Type. Значение '''"1" - EAN13'''. Для кода EAN13 первая строка данных в ячейке должна иметь вид "тип штрих-кода, номер", например "7, 123" (без кавычек, конечно). В этом случае система сформирует штрих-код: "2700000001233". Первая цифра - всегда 2, далее - указанный тип штрих-кода, нули, чтобы получилось 13 символов, номер, указанный в таблице, и один символ - контрольная сумма. Значение '''"2" - CODE128''' (с версии 734). Данные из первой строки ячейки таблицы печатаются в штрих-коде "как есть". Для всех видов штрих-кода (с версии 734) последующие строки печатаются под штрих-кодом в виде текста.

SetMultiHeader(Active) - Включает печать заголовка при переносе таблицы на несколько страниц. По умолчанию отключено.

SetCustomHeader(script) - Включает печать пользовательского заголовка. Script - это код интерпретатора, который должен печатать заголовок на канву. Печать таблицы может происходить на нескольких листах, по этому скрипт будет вызван для каждого листа. При использовании этого метода, автоматически инициализируются переменные: $TablePageNo - номер страницы, нумерация начинается с нуля; $TableY - координата по оси Y, от которой рисуется заголовок. Чтобы таблица была под заголовком необходимо значение переменной $TableY увеличить на высоту заголовка.

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

Пример:
<?>
NEW('TPrinter', 'Prn');
If(prn.ShowDialog,
NEW('TTable', 'Tbl');
NEW('TSelfADO', 'MyDB');
MyDB.Open('SELECT concat("7", ", ", a.code, "\r\n", a.client_id, "\r\n", a.zakaz, "-", a.number) as "Штрих-код", a.target AS "Заказик", address, phone, vlog, poruch FROM address a order by code desc limit 10');
Tbl.LoadFromDB(MyDB.Self);
Tbl.SetBarcode(1, 1);
Tbl.SetCustomHeader(
if($TablePageNo>0,
Prn.Canvas.TextOut(Prn.Canvas.DPIX*0.1, $TableY, 'Продолжение таблицы');
set($TableY, $TableY + Prn.Canvas.TextHeight('H'));
,0)
);
Prn.BeginDoc;
Prn.PrintTable(0, Tbl.Self);
Prn.EndDoc
, );

== Объект TBaseUtils ==

Предоставляет функции, базирующиеся на БД системы «MEASOFT». По-умолчанию, при создании подключается к основной базе данных модуля, в котором выполняется скрипт, если такая определена контекстом, однако это можно изменить, см SetConnection.

Функции:

'''MakeAddress(s[,town])''' – возвращает значение, полученное путем преобразований адреса s для приведения его к внутреннему формату программы. В процессе преобразования до нескольких раз происходит замена буквосочетаний по таблице замены (ее редактирование доступно по нажатию кнопки «Автозамена» в интерфейсе импорта БД из Excel системы (см. Руководство пользователя)), поиск улиц по базе КЛАДР с точностью до одного знака, и некоторые другие операции, нацеленные на исправление ошибок в написании адреса.

С версии программы 2008.0.0.615, при вызове функции в формулах загрузки реестра, в первую очередь происходит проверка строки s на условия:
* в строке s записано число;
* строка s начинается с "ПВЗ ".
Если одно из этих условий выполняется, то функция пытается установить пункт самовывоза - т.е она сама в загружаемой карточке корреспонденции укажет: адрес ПВЗ, город ПВЗ и установит галку самовывоз. Правила поиска ПВЗ:
* Если s число - считаем его внутренним кодом филиала;
* Если s начинается с "ПВЗ " - Например в адресе передана строка "ПВЗ На Ленинском проспекте", то искать будем филиал с названием "На Ленинском проспекте" который подчиненный, активный, с галкой ПВЗ и в городе town. Если город не указан, то ищем филиал во всех городах, и считаем его найденным если найдем только один филиал.
* Если филиалы найти не удалось, функция makeaddress работает как обычно и выполняет преобразование адреса.

Если адрес не содержит русских букв, только латиница, и курьерская служба находится в одной из стран Россия, Белоруссия, Казахстан или Украина, и город-получатель (второй параметр, town) находится так же в одной из этих стран, функция автоматически делает транслитерацию адреса на русский язык.

''SetConnection(DB) – Подключает объект к базе данных DB, где DB – ссылка на объект TADO.Self.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

''SetTown(Town) – Устанавливает код текущего города (используется в некоторых функциях объекта) в значение Town. По-умолчанию текущий город – 1.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

'''SetIndexLength(Length)''' – Устанавливает длину почтового индекса. По-умолчанию – 6.

'''GetIndex(Address)''' – Возвращает почтовый индекс из адреса.

'''GetStreet(Address)''' - Возвращает улицу до первой запятой.

'''GetHome(Address)''' - Возвращает номер дома до второй запятой, но не более пяти символов.

'''GetKurierByStation(station, Mass, Cash, Date_Putn)'''

'''TownByIndex(Index[, PriorityName][, PriorityCountry])''' – Возвращает код города по индексу. В случае ошибки поиска – код текущего города. Если нашлось несколько населенных пунктов, и указано приоритетное название - выбирается населенный пункт, название которого начинается с PriorityName (если есть).

'''TownByName(Name[,NotNeedCL=False, City=0])''' – Возвращает код города по имени. В случае ошибки поиска – возвратит код текущего города. Если параметр NotNeedCL (параметр не обязательный) установить в TRUE, тогда функция возвратит 0, если город не удалось найти. Параметр City (код региона) позволяет ограничить поиск одной областью (не обязательный, по умолчанию не используется).

'''FillClientInfo(Excel, client, Sheet, Row, Col)''' – Выводит в эксель информацию о клиенте с кодом client на лист sheet начиная со строки row и столбца col.

'''SavePrintFormToFile(FormType, FormNumber)''' - Сохраняет на диске файл печатной формы и возвращает путь к нему

'''CreateTrans(Address[, Store][, Operator][,Correction])''' - Формирует запись для печати кассового чека для корреспонденции с кодом Address, для выбора кассового аппарата используется код склада Store. Если Store не указано - при исполнении в среде клиентского модуля системы использует склад, указанный пользователем в окне [[Настройка параметров рабочего места|"Настройка" - "Параметры"]], в остальных модулях - код текущего склада из [[Настройка глобальных параметров|переменной]] "CL" ("Текущий филиал"). Поле Operator позволяет указать кассира (передается код справочника сотрудников). Если не указан, в основной системе будет использован код авторизованного пользователя, в других модулях - 1.
Поле Correction позволяет указать данные для корректировочного чека, используется в системе Штрих-М. По умолчанию пустая строка. Возвращает идентификаторы записей чеков. Может вернуть пустую строку, если чек создавать не понадобилось, один или несколько кодов через запятую, если создано несколько чеков. В случае ошибки вызывает ошибку, поэтому рекомендуется использовать с функцией Try.

'''CreateReturnTrans(Address)''' - формирует запись для печати чека возврата для корреспонденции с кодом Address. Чек возврата печатается на полную сумму и с теми же атрибутами, что и чек продажи. Возвращает идентификатор записи чека возврата. В случае ошибки вызывает ошибку, поэтому, как и с CreateTrans, рекомендуется использовать с функцией Try.

'''CalcTownDeliveryDays(Source, Mode, TownTo, TownFrom)''' - возвращает количество дней необходимых на доставку отправления, только для межгорода. Source - код клиента, Mode - режим срочности, TownFrom - код города отправителя, TownTo - код города получателя.

'''CalcDeliveryDate(Source, Mode, TownTo, TownFrom, Date_Beg, Time_beg)''' - Возвращает планируемую дату доставки с учетом сроков доставки. Работает при городской и междугородней доставке. Для межгорода сроки доставки берутся из зон. Для городской доставки, из дополнительных параметров статуса (17 статус, 1 параметр в доп. информации) Если рассчитать дату планируемой доставки не удалось, возвращает пустую строку. Параметры: Source - код клиента, Mode - режим срочности, TownTo - город получатель, TownFrom - город отправитель, date_beg - дата заказа (может быть передана строкой в формате DD.MM.YYYY или в числовом), time_beg - время заказа.

'''GenSpecialSMA(DirectExcel, Code)''' - функция для генерации отчета о доставке по акту передачи денег. Первый параметр - указатель на TDirectExcel, второй параметр - код акта передачи денег. АПД выводится на текущий лист объекта TDirectExcel.

'''CreateSpecialSMA(ClientCode, DateTo)''' - Функция создает исходящий акт передачи денег (АПД). Требует ClientCode - код клиента, DateTo - дату акта. Функция возвращает коды созданных актов. Если возвращаемых параметров два, значит функция пыталась создать два АПД: первым, идет код АПД с наличной оплатой, а вторым с безналичной. Примеры возвращаемого результата: '0'- акт не был создан, отсутствуют корреспонденции; '124' - код созданного акта; '0,0' - пытались создать два акта, но отсутствуют данные; '4556,0' - создан только наличный АПД; '0,445' - создан только безнал.; '4556,445' - созданы нал. и безнал.

'''CreateAddressForActDelivery(ActCode, [DeliveryDateMode=0, Delivery=True])''' - Функция создает корреспонденцию на доставку акта. ActCode - код акта; DeliveryDateMode: 0 - установить план. дату доставки текущим рабочим днем, 1 - установить план. дату доставки следующим рабочим днем, 2 - установить план. дату доставки равной планируемой дате оплаты АПД; Delivery - создать корр. на доставку АПД или создать корреспонденцию на забор АПД (по умолчанию, доставка АПД). Работа функции может быть изменена системной доп. возможностью OnCreateAddressForActDelivery.

'''CreateAddressTransferAct(ClientCode, Store, DateTo, [AdditionalParam])''' - Функция создает исходящий акт передачи корреспонденции (АПК). Требует ClientCode - код клиента, Store - код филиала, для которого будет создан акт, DateTo - дату, до которой в акт попадут возвраты, AdditionalParam - дополнительный строковый параметр для передачи в системную доп. возможность ExceptionsForAPK, позволяющий отобрать в акт, например, только полные возвраты. Возвращает код созданного акта. ВНИМАНИЕ: при создании АПК используется системная функция ExceptionsForAPK. Если в ней используются интерактивные функции (вывод сообщений, диалоговые окна, выполнение скриптов), то акт сформирован не будет, а функция CREATEADDRESSTRANSFERACT вернет ошибку.

'''GetPolygonByAddress(Address, TownCode, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попал адрес. Если полигон найти не удалось, функция возвратит пустую строку. Address - адрес корреспонденции текстом; TownCode - код города; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByAddress(addressrecord.address, if((addressrecord.number=0)*(addressrecord.strbarcode=<nowiki>''</nowiki>), addressrecord.townfrom, addressrecord.townto), '`schema`=1') - пытаемся найти вхождение адреса в полигоны 1 схемы, при выборе города учитывается корр. на забор, у нее нужно использовать город-отправитель (а для обычной корр. нужен город-получатель).

'''GetPolygonByLatLon(Lat, Lon, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попали GPS координаты. Если полигон найти не удалось, функция возвратит пустую строку. Lat - широта текстом; Lon - долгота текстом; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByLatLon('55.769064','37.590713','zone is not null and price=0') - пытаемся найти вхождение координат в полигоны, где задана зона, для всех клиентских и курьерских зон.

'''GetLatLonByAddress(AddressText, TownCode)''' - возвращает географические координаты вида lat,lon указанного в AddressText адреса. Поиск производится в городе, имеющем код TownCode в таблице Town.

'''GetRouteCode(AddressText, TownCode, LatLon[, Lon])''' - для адреса AddressText в городе с кодом TownCode (из таблицы Town) по географическим координатам lat, lon возвращает код роута (записи, хранящей координаты адреса в городе). Если роут не найден (для адреса в городе не найдено записи с указанными координатами) - создает новый роут и возвращает его код, если роут найден (был создан ранее) - обновляет у роута координаты. Если параметр Lon задан, то параметр LatLon должен содержать одну координату, иначе LatLon должен содержать строку вида 'lat, lon'.
В случае ошибки возвращает Null.

Пример: 
Set($res, GetRouteCode(address, townto, '55.114034, 36.592397')); 
Set($res, GetRouteCode('Троицк, Полковника милиции Курочкина ул., 11', 1, '37.467446, 55.740537')); 
Set($res, GetRouteCode('Обнинск, Маркса пр., 20', TownByName('Обнинск'), 55.114034, 36.592397));

'''CalcAgentPrice(AddressCode, AgentCode, TownFrom, TownTo, Mode, [, Count=1])''' - функция возвращает стоимость доставки рассчитанную по тарифу агента. AddressCode - код адреса, AgenCode - код филиала (агента), TownFrom - код города отправителя, TownTo - код города получателя, Mode - режим срочности, count - тарифная сетку от указанного количества отправлений (по умолчанию 1)

'''SetAddrKol_vo(address, getkol_vo)''' - функция делает прием корреспонденции в текущем ответственном филиале. address - внутренний код адреса, getkol_vo - количество принимаемых мест, может принимать значения: "kol_vo" - принять все места, "getKol_vo+1" - принять еще одно место, "число" - сделать количество принятых мест равным указанному числу.

'''CalcClientCnt(client_code, date, is_intown [, date_put=CurrDate(), skipajust=false])''' - функция расчета количество доставленных корреспонденций у клиента с кодом client_code за предыдущий месяц от даты date (Или за текущий месяц, подробнее смотри переменную UseCurrentMonthCount) среди внутригородских (is_intown = true) либо междугородних (is_intown = false) корреспонденций, date_put - дата доставки (для альтернативного способа подсчета, включаемого переменной UseDatePutForCalcCnt), skipajust - не учитывать принудительно введенные количества (таблица priceclientadjust типы записей 0 и 1).

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset._self".
Описание некоторых полей датасета:
pmoney - процент от суммы;
pmoneycard - процент от суммы при оплате картой;
pricecode - код прайса (таблица Price) ;
distarea - район метро получателя (актуально при отключённом едином районировании, как правило район от 200 до 299 является признаком области);
region - признак области при включенном едином районировании;
distareaFrom и regionFrom - аналог distarea, region только для отправителя;
pcncode - код записи таблицы pricecnt "количество от";
Запрос содержит поля таблицы pricelinesnew - начальная стоимость по тарифной сетки, найденные без учета массы,только по типу срочности и режиму.
Запрос содержит поля таблицы price.

*addressrecord - ссылка на объектную модель карточки корреспонденции, следует использовать уже созданную addressrecord._self
*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*type - тип корреспонденции;
*mode - режим доставки;
*wait - количество минут ожидания (не учитывается при доп. услугах, есть системная услуга "ожидание");
*mass - масса отправления;
*rur - сумма передаваемых денег (не учитывается при доп. услугах, есть системная услуга "процент от суммы");
*inshprice - сумма страховки (не учитывается при доп. услугах, есть системная услуга "процент от объявленной стоимости");
*distance - расстояние до места доставки, обычно поле заполняется при доставке в область (регион в едино районировании). Дополнительная наценка к стоимости доставки;
*forward - направление доставки: true - туда; false - обратно;
*Collection - признак заборной корреспонденции: true - забор, false - доставка (В тарифе есть возможность указать стоимость для забора);
*TownFrom - код города отправителя;
*TownTo - код города получателя.

В тарифе есть возможность указать формулу, которая может влиять на базовый расчет. Формула может объявить служебные переменные, которые:
*$FormulaReplace - если true – возвращаемое значение полностью заменяет базовый расчет;
*$FormulaKoeff - коэффициент на который будет помножена базовая стоимость.
Также внутри формулы объявлены следующие объекты dataset, addressrecord и переменные:
*$ForceIntown - Переменная становится истиной, если междугородний расчет был отменен, т.к. адрес попал в нарисованную зону на карте.
*а также: $forward, $distance, $Count, $Collection, $Wait, $FormulaKoeff, $PriceCode - описание есть выше.

Для направления "туда", Функция GetBasePrice вызывается через доп. услугу "База" (при включенных доп. услугах), для направления "Обратно" всегда вызывается напрямую (т.к. доп. услуги работают только в для направления "туда").
На расчет этой функции влияют следующие переменные: "Финансы" -> "Расчет стоимости по адресу", "Финансы" -> "Зона клиента по умолчанию", "Финансы" -> "Подсчет кол-ва отправлений за месяц".

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset.self".

*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*tp - тип корреспонденции;
*mode - режим доставки;
*mass - масса отправления;
*TownFrom - код города отправителя;
*TownTo - код города получателя.

'''CalcAddressPrice(AddressCode, [,ZakazCount])''' - полностью пересчитывает стоимость доставки корреспонденции по тарифу клиента. AddressCode - внутренний код адреса, ZakazCount - не обязательный параметр, кол-во заказов от клиента.

'''GetStationCode(s [,town])''' – возвращает код станции метро, ассоциированный в системе с адресом s. В случае невозможности идентифицировать станцию метро – возвращает 0.
Когда включено районирование по карте, необходим второй параметр "town" - код города в котором нужно искать адрес. Возвращает код района если удалось его найти; код станции меж-города - если адрес удалось геокодировать, но район не нашли; код 0 - когда не удалось геокодировать адрес.

'''RecalcSpecialSMA(ActCode)''' - пересчитать акт передачи денег (АПД). Также, у корреспонденций входящих в АПД будет пересчитана стоимость доставки. Для Входящего АПД сумма акта не пересчитывается. Параметр ActCode - внутренний код акта, коды можно перечислять через запятую.

'''UserCode''' - Возвращает код текущего пользователя из таблицы «Пользователи» (users).

'''UserName''' - Возвращает имя текущего пользователя из таблицы «Пользователи» (users).

'''UserPass''' - Возвращает пароль текущего пользователя.

'''UserBaseCode''' – Возвращает код текущего пользователя из таблицы «Сотрудники» (kurier).

'''UserEmail''' - Возвращает e-mail текущего пользователя.

'''CurrentTown''' – Возвращает код текущего города (из таблицы town).

'''CurrentCity''' – Возвращает код текущего региона (из таблицы city).

'''CurrentLocation''' – Возвращает код текущего филиала (из таблицы store).

'''FromEmailStr''' - строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

'''FillExcelDoc'''(Excel, Dataset, FormType, FormNumber,Print,[printer]) - Выполняет указанную печатную форму в объекте excel. Excel объект можно не указывать, тогда функция сама создаст объект экселя и разрушит его, полезно когда книгу
нужно распечатать или отправить по email (на листе данных в ячейке 1,1 укажите ключевое слово email). Dataset объект с данными для скрипта в печатной форме, может быть null. Dataset передавать можно так db.self, тогда переданный dataset внутри печатной формы будет доступен по имени dataset. Print - печатает книгу на принтере, после печати объект excel разрушается, при использовании параметра не указываете объект excel. Printer - имя принтера, на котором печатать (по умолчанию пустая строка, что означает "печатать на принтере по умолчанию"). Например:

new('TExcel', 'excel');
FillExcelDoc(excel.self, null, 12, 1);
excel.DoNotDestroy(true);
excel.SetVisible(true);
''Покажет эксель с выполненной печатной формой''

'''ValutaSign''' – Возвращает название валюты для суммы.

'''SendToMeasoft(xml)''' - Отправляет запрос в клиентское API Measoft. Автоматически добавляет начальный "<?xml version="1.0" encoding="utf-8"?>".

'''InsertFirmAtt(excel, sheet, firmcode)''' - Вставляем на лист эксель по коду фирмы: печать, подпись, подпись бухгалтера, логотип. Тэги <STAMP>, <DIR>, <BUH>, <LOGO> соответственно. После тега можно указать размеры изображения в символах Microsoft Excel. Формат записи: <STAMP> 16, 16

'''PreCalcSalary(kurier, addressCodes)''' - Рассчитывает предварительную зарплату. Kurier - код курьера, используется для определения тарифа. addressCodes - коды адресов, через запятую для которых необходимо посчитать зарплату. Результаты расчета будут записаны в таблицу kurierpaydetail, так как расчет предварительный то записи не будут прикреплены к конкретному начислению.

select a.code, kpd.price as "туда", kpd2.price as "обратно" from address a
left join kurierpaydetail kpd on kpd.sourcetable=3 and kpd.sourcecode=a.code and kpd.rectype = 1
left join kurierpaydetail kpd2 on kpd2.sourcetable=3 and kpd2.sourcecode=a.code and kpd2.rectype = 2
where a.code in (...)

'''CalcSalary(DateTo, [Filter=0, KurierCode = 0, ManagerCode = 0])''' - Полный расчет зарплаты курьерам. DateTo - дата до которой создается начисление. Условия отбора курьеров для начисления. Filter - роль сотрудника: 0 - Все, 1 - курьеры, 2 - менеджеры; KurierCode - код курьера, ограничить расчет зарплаты одним курьером;ManagerCode - код курьера, ограничить расчет зарплаты курьерами указанного менеджера. Внимание фильтры Filter, KurierCode и ManagerCode накладываются друг на друга. Результатом функции является SubSQL с информацией по созданным начислениям.
поля ответа: код курьера, код менеджера, начислено, бонусы, штрафы, аванс, итого;
select kurier, manager, profit, bonus, shtraf, prepay, total [union select ...]

'''SelDistAddr(s)''' – Возвращает строку для вставки в select запрос, для вывода поля с упрощенным адресом. Принимает один необязательный строковый параметр - алиас таблицы из которой будет упрощаться поле address, по умолчанию "a"

'''VoiceReadStr(str)''' – Озвучивает фразу str голосовым уведомлением доступными словами из базы. Может содержать тег "{break_off}" для того, чтобы сделать эту фразу не пропускаемой в очереди воспроизведения.

'''CalcStorageCost(ClientCodes, DateFrom, DateTo, NeedReport[, Store])''' – рассчитывает стоимость хранения на складе для выбранных клиентов (ClientCodes - коды клиентов через запятую), в период дат с DateFrom до DateTo, с прикреплением к корреспонденции отчета в зависимости от выставленного параметра NeedReport. Может содержать параметр Store - код филиала, по умолчанию пустой (расчет выполняется для всех филиалов). Возвращает коды созданных корреспонденций через запятую.

'''WriteOut(DocId, ItemId, Date, Cnt[, BC])''' – производит списание товара со склада. DocId - код (docs.code) документа списания, ItemId - код товара (item.code), Date - дата операции, Cnt - количество списываемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер. Если указан BC, то параметр ItemId игнорируется и поиск номенклатуры происходит исключительно по штрих-коду. В случае успеха, функция возвращает строку вида: код номенклатуры, списанное кол-во.

'''IncomePurch(DocId, ItemId, Date, Cnt[, BC, Location = CurrentLocation])''' – производит приход товара на склад. DocId - код (docs.code) приходной накладной, ItemId - код товара (item.code), Date - дата операции, Cnt - количество приходуемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер, Location - код склада (store.code). В случае успеха, функция возвращает строку вида: код номенклатуры, введенное кол-во.

'''CreateLedgerDoc(Date, Client, UserCode, Type[, ExtNumber, Message])''' - создает складской документ и возвращает код этого документа. Date - дата документа. Client - код клиента. UserCode - код пользователя, создавшего документ. Type - тип документа (statetype = 13). ExtNumber - номер у поставщика для документов прихода и расхода. Message - комментарий к документу. Последние два аргумента не обязательные и могут быть пустыми.

== Объект TINIFile ==

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

Функции:

IniParam(s[,section='common']) – Существует только если имя экземпляра объекта пустое. Возвращает значение параметра s ini-файла секции «common», изменить секцию можно не обязательным параметром section. В случае отсутствия параметра в файле возвращает пустую строку.

Param(s) – Синоним IniParam с тем отличием, что существует только если имя объекта непустое.

SetText(s) - Загружает ini файл из строки s. Если в файле нет секции «common», то принудительно объявляет ее в начале.

== Объект TSMS ==

Предназначен для отправки SMS, а также проверки статуса их доставки.

Функции:

SetProxy(Server, Port, User, Pass) - Устанавливает настройки прокси-сервера.

Connect(Provider, Host, User, Pass, SenderName, SMSPrefix) – Подключает объект к провайдеру provider, используя адрес Host, имя пользователя User и пароль Pass. Значение SMSPrefix предназначено для того, чтобы провайдер мог различить сообщения от разных филиалов, если этими филиалами используется одно подключение. Если необходимости разделять сообщения нет - значение SMSPrefix можно не указывать.
Для провайдера доступны значения 'mirsms', 'sms16', 'websms', 'epochta', 'zanzara', 'SMSManager', 'f1sms', 'BitCall', 'mirsmsGET', 'AMD' и другие, либо можно указать числовые значения номера протокола, от 1 до <rspoiler text="20">Набор провайдеров все время дополняется, количество и номера можно смотреть в Справочники - Переменные - Подключения - SMS</rspoiler> соответственно. Эти значения соответствуют значениям переменной SMSProtocol таблицы "Value".

SendSMS(Phone, Text, [ID]) – Отправляет SMS с текстом Text на телефон Phone. Для некоторых провайдеров необходим уникальный идентификатор сообщения ID (для провайдера iVoice - идентификатор сценария (кампании)). Возвращает ID провайдера для последующей проверки статуса доставки.

CheckSMS(ProviderID) – Проверяет состояние доставки сообщения с идентификатором ProviderID. Возвращает: 0 – доставляется, 1 – успешно доставлено, 2 – не доставлено.

ReceiveSMS(InboxID, DateFrom, DateTo, NewOnly) - Получает входящие SMS, с ящика InboxID (идентификатор выдаётся провайдером). DateFrom, DateTo - задается временной интервал в котором были приняты сообщения(формат 08.04.2013 18:00:00 'DD.MM.YYYY HH:NN:SS'). Чтобы получать только новые сообщение поле NewOnly должно быть True. Возвращает XML с сообщениями.

ExtraResult([ParamName='']) - Вызывается после CheckSMS, возвращает дополнительную информацию по последнему статусу смс. В настоящее время работает только для провайдеров BitCall и iVoice. Для BitCall по умолчанию возвращает кнопки, нажатые абонентом во время работы с голосовым меню. Если в paramname указать 'IdentifyText' то будет возвращен JSON с ответами абонента на заданные вопросы(используется в случае звонков с индивидуальным сценарием). Для iVoice по умолчанию подразумевается параметр 'response', при этом будет возвращен JSON с ответами абонента на заданные вопросы (в зависимости от сценария)

Log - Возвращает последний HTTP запрос и ответ от сервера смс.

== Объект TXML ==

Предназачен для парсинга XML-данных.

Функции:

SetText(S) – Задает текст XML документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию. Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

AttribCount – Возвращает количество атрибутов текущего элемента.

AttribName(i) – Возвращает имя атрибута с номером i.

Attrib(V) – Ищет атрибут и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

Reset – Делает текущим корневой элемент, возвращает его значение.

== Объект TJSON ==

Предназачен для парсинга JSON-данных.

Функции:

SetText(S) – Задает текст JSON документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Можно проверять наличие элементов, если элемента нет, вернется пустая строка.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

Reset – Делает текущим корневой элемент, возвращает его значение.

isArray - Возвращает true, если текущий элемент является массивом (доступ к дочерним элементам возможен только по индексу, нумерация элементов начинается с нуля)

==Объект TZip==
Предназначен для работы с Zip архивом.

SetZip(s) - Загружает архив в объект из строки s;

GetZip - Возвращает архив в виде строки;

AddFromFile(SrcPath, ZipPath) - Добавляет файл SrcPath в архив и располагает его по пути ZipPath. ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

AddFromStr(Data, /*ZipPath*/) - '''параметр ZipPath временно не работает'''. Добавляет файл из строки Data в архив и располагает его по пути ZipPath. -ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

LoadFromFile(path) - Загружает архив из файла path;

SaveToFile(path) - Сохраняет архив в файл path;

Count - Возвращает кол-во файлов в архиве;

DataByIndex(index) - Возвращает распакованный файл в виде строки. Index - номер файла в архиве;

DataByName(ZipPath) - Возвращает распакованный файл в виде строки. ZipPath - путь к файлу в архиве, может содержать каталоги;

FileName(index) - По номеру файла, функция возвращает полный путь файла в архиве.

==Объект TBase==

'''Функции общего назначения''':

'''ExecSimpleScript(Caption, Text)''' - Выполняет скрипт "Дополнительных возможностей". Возвращаемые значения, введенные пользователем устанавливает в переменные $scriptvar1..$scriptvarN, Значения кодов списочных переменных - в переменных $scriptvar1codes..$scriptvarNcodes. Функция возвращает истину, если пользователь нажал "OK" в диалоговом окне.

'''FillAdvPriceReport(Excel, AddressCodes, StartLine, StartCol, [ShowSumPrice,InsertColumns,ShowAll])''' - добавляет отчёт по дополнительным услугам. В AddressCodes - указаны коды адресов через запятую, каждый код это отдельная строка отчета. Адреса будут показаны в порядке перечисления их в AddressCodes. Если в отчет нужно добавить пустую строку, то можно указать код адреса -1000. StartLine, StartCol - верхний левый угол выгружаемой таблицы. ShowSumPrice - добавить столбец итоговый столбец с суммой всех услуг, по умолчанию выключено. InsertColumns - раздвинуть таблицу перед вставкой отчета, позволяет встраивать отчет посередине выгрузки, по умолчанию выключено. ShowAll - показать все дополнительные услуги, по умолчанию false и показывает только услуги с начислениями. Функция возвращает количество использованных столбцов.

'''PrintSticker(Codes, [ToBoxes=False])'''

'''PrintBlanc(Codes, BlancNumber)''' - печатать форму из раздела "Заполнить бланк". Codes - коды корреспонденций, BlancNumber - номер формы из раздела "Бланки для корреспонденции" (3)

'''GetItemByName(Name)'''

'''GetA4Printer([GetPrinterPort=False])''' - возвращает имя принтера выбранного для печати документов. GetPrinterPort - попытаться по имени принтера найти порт принтера, используйте для печати через команду ghostscript. Определение порта работает только с физическими устройствами LPT, USB, TCPIP.

'''GetStickerPrinter([GetPrinterPort=False])''' - возвращает имя принтера выбранного для печати стикеров. GetPrinterPort - попытаться по имени принтера найти порт принтера, используйте для печати через команду ghostscript. Определение порта работает только с физическими устройствами LPT, USB, TCPIP.

'''GetDuplexPrinter([GetPrinterPort=False])''' - возвращает имя принтера выбранного для двусторонней печати, если принтер не выбран, возвращает пустую строку. GetPrinterPort - попытаться по имени принтера найти порт принтера, используйте для печати через команду ghostscript. Определение порта работает только с физическими устройствами LPT, USB, TCPIP.

'''PrintAttachPDFPage(Code, FileName, Page, Printer)''' - печатает страницу из вложенного файла PDF. Code - код вложения (attachment) или путь к файлу, Page - номер страницы, Printer - 0 = принтер A4, 1 = принтер этикеток.

'''AttachPDFToText(Code, [TextFileName])''' - преобразует файл PDF из вложений в текст. Code - код вложения (attachment) или путь к файлу, TextFileName - имя текстового файла, в который записывается результат (если не указан, используется временный файл). Возвращает текст в виде строки.

'''GhostScript(GScript, Code)''' — функция для выполнения консольных команд утилиты [https://ghostscript.readthedocs.io/en/latest/Use.html ghostscript]. Где, GScript — строка с командами Ghostscript; Code — код вложения или путь к PDF-файлу, предназначенному для обработки. В командах доступен специальный тег %MeasoftInFile%, который автоматически заменяется на путь к предварительно загруженному файлу (Code). Если в команде необходимо указать путь для сохранения результата обработки, используйте тег %MeasoftOutFile%. В этом случае функция на основании параметра Code автоматически сформирует имя временного выходного файла. После успешного выполнения команд функция возвращает путь к сгенерированному выходному файлу - %MeasoftOutFile%.

'''GetActiveForm([SkipFormName])''' - возвращает код активной формы в программе где происходит сканирование. SkipFormName - не обязательны параметр, имя формы которую нужно пропустить при определении интерфейса.
'''Список интерфейсов''':
0 - неопределенный;
1 - прием корреспонденции на склад;
2 - АПД;
3 - комплектация адресов (ShelfingForm);
4 - доска приема;
9 - вкладка «Манифесты»;
10 - Инвентаризация корреспонденции;
11 - АПК;
12 - вкладка «Адреса»;
13 - вкладка «Выдача»;
14 - вкладка «Склад»;
15 - Список номенклатуры;
16 - Инвентаризация склада;
17 - Приходная накладная;
18 - Списание товара;
19 - Карточка корреспонденции.

'''AddAddressScanLog(Code[, StrBarCode, IsManual, FromInterface, ExtraInfo])''' - добавляет событие сканирование для корреспонденции с кодом Code. Необязательные параметры: StrBarCode - сканируемый ШК корреспонденции (по умолчанию пустой), IsManual - галка ручного сканирования (по умолчанию false), FromInterface - код интерфейса сканирования (StateType=81, по умолчанию 0 - неопределенный), ExtraInfo - текстовый комментарий события.

'''RuleName(alias)''' - Выдает полный путь в дерева прав по псевдониму права.

'''ShowText(Caption:string, Value:string)''' - показывает пользователю окно с заголовком Caption и с многострочным полем со значением Value. Может быть полезен при отображении логов выполненной операции.

'''ShowScanError(msg [, Speek, Color, Abort])''' - выдает пользователю окно с текстом msg блокируя последующие действия сканирования. Если Speek - истинно, то сообщение проговаривается голосовым движком, по умолчанию выключено. Color - целочисленное число цвета, в который будет окрашен фон сообщения (по умолчанию = -1, стандартный). Abort - прервать выполнение скрипта, не показывая ошибку.

'''CheckRule(alias)''' - функция проверки разрешения у текущего пользователя системы, alias - псевдоним права. Возвращает 1, если право есть и 0, если права нет.
Пример: if(CheckRule('RSE'), ShowMessage('У пользователя есть право изменять счета'), ShowMessage('У пользователя нет права изменять счета'));

'''GetKurierMoney(KurierCode, DateEnd, NonCash)''' - возвращает баланс курьера с кодом KurierCode на дату DateEnd. NonCash - булевый флаг, если истинно, то будет рассчитан безнальный баланс;

'''Функции, работающие только в импорте БД из эксель:'''

ReplaceAddress

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

GetPrice

GetNewNumber - используется при импорте реестра, возвращает номер конверта в загружаемом заказе

GetNewPos - используется при импорте реестра, возвращает порядковый номер вложения

GetNewPackagePos- используется при импорте реестра, возвращает порядковый номер места

Zakaz - возвращает номер заказа куда происходит импорт реестра

addresscode - используется при импорте реестра, код созданного адреса

Source - код заказчика

ClientTown - Узнаем город клиента, через филиал с которым он работает. Сам клиент берется из заказа указанного в окне "Импорт БД из Excel".

== Объект TFieldObject ==
Создается только автоматически. Объект для доступа к записям, используется в картах и дополнительных услугах (addressrecord) и событиях карточки корреспонденции (fieldlist). Методы объекта:

'''_GetTableInfo''' - возвращает данные о полях и примеры данных объекта.

'''_Self''' - возвращает ссылку на объект.

'''_Set(fieldname, fieldvalue [, DoUpdateForm])''' - Если базовый объект строка. Устаналивает для поля fieldname значение fieldvalue. DoUpdateForm по уолчанию false, если указать true то обновление поля будет не только в объекте но и пользовательском интерфейсе. Обновление работает только в карточке корреспнденции для ограниченного набора полей: vlog, mode, type, date_put, time_put, message, kurier, state1.

'''_Set(keyfield, keyvalue, filed, value)''' - Если базовый объект таблица (addressrecord.boxes). Работает перегруженная версия метода _set, cначала происходит поиск строки по ключу, далее меняется значение указанного столбца. keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Пример, отключение услуги база:

addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

== Объект TMessage ==
Создается только автоматически. Объект используется для скриптовой обработки письма в [https://wiki.courierexe.ru/index.php/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F_%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8#.D0.98.D0.BC.D0.BF.D0.BE.D1.80.D1.82_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85| заданиях импорта данных]. В себе содержит текст письма в очищенном формате и оригинальном формате HTML, отправитель письма, тему письма, дата получения и список прикрепленных файлов.

'''Message.Text''' - возвращает очищенный от HTML-тегов текст письма.

'''Message.HTMLText''' - возвращает оригинальный текст письма со всеми HTML-тегами.

'''Message.Sender''' - возвращает email-адрес отправителя письма.

'''Message.AttachmentsCount''' - возвращает количество вложенных файлов.

'''Message.DateTime''' - возвращает дату и время получения письма.

'''Message.Subject''' - возвращает тему письма.

'''Message.GetAttachmentDataString(Number)''' - возвращает вложенный файл под номером Number в виде строки.

'''Message.GetAttachmentName(Number)''' - возвращает имя вложенного файла под номером Number.

== Объект TStringList ==
Может использоваться для построчной обработки многостраничных файлов либо для организации текстовых данных. Номер строк начинается с 0.
Имеет следующий функционал:

'''Count''' - возвращает количество строк в списке.

'''Add(Value:string)''' - добавляет значение Value в конец списка.

'''SetText(Value:string)''' - устанавливает значение списка в значение Value.

'''Insert(Number:integer, Value:string)''' - добавляет строку Value в позицию Number.

'''Delete(Number:integer)''' - удаляет строку из списка в позиции Number.

'''Clear''' - очищает элементы списка.

'''LoadFromFile(Path:string)''' - загружает текстовый файл по пути Path.

'''Strings(Number:integer)''' - возвращает строку с номером Number.

'''SetString(Number:integer, Value:string)''' - устанавливает значение строки с номером Number в значение Value.

'''Text''' - возвращает полный список строк в виде текста.

'''CommaText([Quoted:boolean])''' - возвращает список значений через запятую. Если Quoted = true, то квотирует элементы списка. По умолчанию равен false.

'''SetCommaText(Value: string)''' - разбивает значение Value на отдельные строки и кладет в список. Разделитель - запятые.

'''IndexOf(Value:string)''' - ищет значение Value среди элементов списка и если находит, то возвращает номер строки. Возвращает -1 если значение не было найдено.

'''Sorted(Value:boolean)''' - устанавливает флаг отсортированности списка в Value. Если Value = true, то сразу же его сортирует. По умолчанию Value = false.

'''Exchange(Pos1:integer, Pos2:integer)''' - меняет элементы списка с позициями Pos1 и Pos2 местами.

'''Duplicates(Value:integer)''' - изменяет параметр управления дубликатами в списке. Если Value = 0 (значение по умолчанию), то список не реагирует на дубликаты. Если Value = 1, то список при добавлении будет игнорировать дубликаты. Если Value = 2, то список будет выдавать исключение, при добавлении дубликата в список.

'''ParamName(Number:integer[, Delimiter:string])''' - возвращает текст до первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает пустоту.

'''ParamValue(Number:integer[, Delimiter:string])''' - возвращает текст после первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает всю строку.

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

Основные методы:

'''New'''(FuncName, Param1, Param2, ..., Body) — создание новой функции.Функция возвращает результат выполнения последней команды в теле функции. Аргументы:
* `FuncName` — имя функции (строка)
* `Param1, Param2, ...` — имена параметров функции (переменные начинаются с `$`, объекты — без префикса)
* `Body` — тело функции (скрипт, выполняемый при вызове)

'''FuncName'''(Arg1, Arg2, ...) — вызов созданной функции по имени. Если в объявлении была указана тип переменная, то и подставлять в аргумент надо обязательно переменную. Будет передано значение этой переменной (переменные словарине поддерживаются!). Если был объявлен объект, то указатель на объект должен быть получен через метод '''_self'''. C функциями поддерживают работу следующие классы: TExcel, TDirectExcel, TCSVFile, TADO, TSelfADO, TPrinter, TCanvas, TPicture, TTable, TINIFile, TSMS, TXML, TJSON, TZip, TStringList, TBaseUtils, а также объект addressrecord (TFieldObject). Результатом работы функции может быть число или строка.

Пример 1, обработка результатов функции:
<source>
<?>
new('TFunc', 'calc');
calc.new('Sum', '$a', '$b',
$a + $b
);

set($x, 10);
set($y, 20);
showmessage(calc.Sum($x, $y));
</source>

Пример 2, передача объекта в функцию:
<source>
<?>
new('TFunc', 'utils');
utils.new('ProcessDB', 'dbConn', '$value',
showmessage($value);
dbConn.open('SELECT * FROM address limit 3 ');
if(dbConn.recordcount > 0,
showmessage('Найдено записей: ' + dbConn.recordcount);
dbConn.first;
while(dbConn.eof = 0,
showmessage(dbConn.fieldbyname('code'));
dbConn.next
)
,0)
);

new('TSelfADO', 'db');
utils.ProcessDB(db._self,'test!');
</source>

== Применение языка формул ==
'''в различных контекстах системы «MEASOFT» и сопутствующих проектах'''

=== MEASOFT ===

==== Дополнительная информация на чеке ====

В карточке клиента на закладке «Касса» имеется поле для ввода текста, который будет отображаться на кассовых чеках, печатаемых для корреспонденции от данного клиента. В поле может быть введен как просто текст, так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TSelfDB с открытым набором данных со строчкой корреспонденции, заказа и клиента, на которую печатается чек

TBaseSupport

TBaseValue

Все объекты создаются с пустыми именами.

Так же система записывает в переменную $CashRegisterID вычисленный код фискального регистратора, на котором предполагается печать чека.

Результат работы скрипта печатается на создаваемом чеке, если скрипт не возвращает значение “-1” (число или текст) – в этом случае система чек не создает. Подразумевается, что либо скриптом было принято решение об отсутствии необходимости формирования чека, либо скрипт взял эту функцию на себя.

==== Заполнение шаблонов печатных форм ====

==== Дополнительные возможности ====

==== Импорт БД из Excel ====
В окружении интерпретатора создается объект ZakazRecord, он является списком со значениями таблицы zakaz. Именно в этот заказ будут загружены данные. Из этого объекта также доступно : 
*ZakazRecord.userfields - пользовательские поля заказа;
*ZakazRecord.Clients - данные таблицы clients;
*ZakazRecord.Clients.userfields - пользовательские поля заказчика.

==== Прайс лист клиента ====

Формула возвращает сумму в валюте клиента для каждой поездки (туда или обратно) единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Помимо стандартных объектов, система создает объект AddressRecord, в котором, как свойства, доступны все поля текущей записи. Так же она выставляет значение переменной $Forward в 1 (истина), если необходимо произвести расчет для направления "Туда" и 0 (ложь) - если обратно. ВНИМАНИЕ! Как и во всех остальных местах, после формулы нельзя ставить ";", иначе скрипт вернет 0!

Например:

if(int(AddressRecord.Time_Put_Max)>19, 100, 0)

''Прибавляет 100 рублей в случае, если максимальный срок доставки 20 часов или более''

if(pos(AddressRecord.Address, 'Аренда')>0,
set($FormulaReplace, 1);
1500
, 0)

''В случае наличия подстроки "Аренда" в адресе заменяет штатное ценообразование на 1500 рублей''

Объект AddressRecord может предоставить доступ к связанным таблицам :
* addressrecord.boxes
* addressrecord.packages
* addressrecord.clients
* addressrecord.price
* addressrecord.advprice
* addressrecord.userfields
* addressrecord.addressfld
* addressrecord.clients.userfields
* addressrecord.price.userfields
* addressrecord.zakaz
* addressrecord.zakaz.userfields

Чтобы получить доступ к полю VarCode из таблицы userfields необходимо записать AddressRecord.Userfields.VarCode. В присоединённой таблице может быть несколько записей чтобы получить к ним доступ предусмотрены функции _First, _EOF, _Next, _RecordCount, _Set.

Пример:
set($value1, 0); set($value2, 0);
while(AddressRecord.userfields._EOF=0,
if(AddressRecord.userfields.varCode=1,
set($value1, if(AddressRecord.userFields.VarValue='Праздничная упаковка', 150, 0)), ''''''');
if(AddressRecord.userfields.varCode=2,
set($value2, AddressRecord.userFields.VarValue), ''''''');
AddressRecord.userFields._Next;
);
int($value1) + int($value2)

Пример делающий тоже самое что и выше но через поиск Locate:
set($value1, if(addressrecord.userfields.VarValue('VarCode', 1)='Праздничная упаковка', 150, 0));
set($value2, int(addressrecord.userfields.VarValue('VarCode', 2)));
$value1 + $value2

В скрипте доступны переменные:
«$FormulaKoeff» - это коэффициент на который умножится конечная цена (по умолчанию равна 1);
«$PriceCode» - код прайса;
«$CurrentPriceConf» - код услуги;
«$BasePrice» - стоимость всех услуг с уровнем (pricelevel) меньше текущего.

Для вызова функции CalcBasePrice (Расчёт базовой цены) в скрипте объявленны переменные: $Count,$Collection,$Distance,$Wait.

Существует поиск по ключевому полю (поиск регистронезависимый), например чтобы найти в таблице advprice введённое значение для текущей услуги, нужно сделать такую запись addressrecord.advprice.value('priceconf', $CurrentPriceConf) - Первый параметр это ключевое поле, второй искомое значение. Если запись найдётся будет возвращено значение поле value, если нет функция вернёт значение 0.

Пример
if(addressrecord.advprice.active('priceconf', 3)='T', addressrecord.advprice.price, 0)

''Смотрим включена ли услуга и если да, возвращаем рассчитанную стоимость

Чтобы изменить значение записанное в объект addressrecord, нужно воспользоваться методом _set(keyfield, keyvalue, filed, value). Параметр keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Сначала происходит поиск строки по ключу, далее меняется значение указанного столбца.
Пример, отключение услуги база:
addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

Также существует упрощенный метод _set, с двумя параметрами filed, value - он используется в шаблонах загрузки или в системных доп. возможностях где доступен объект addressrecord.

==== Зарплата курьеров ====

Формула возвращает сумму в основной валюте для каждой единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Переменные «$FormulaTablKoeff» и «$FormulaMoneyKoeff» позволяют установить повышающий или понижающий коэффициент на стоимость доставки (по тарифной сетке) и услуги соответственно (процент от суммы, процент от стоимости доставки, ожидание). Переменная «$UsingZoneName» и «$KurierZone» содержат название и код зоны соответственно, есть возможность поменять название зоны для отчета.

=== Планировщик ===

В поле текста задания может быть введен как текст с командами планировщика (см ниже), так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TIniFile, Указывает на настроечный ini-файл планировщика.

Все объекты создаются с пустыми именами.

Для записи в лог планировщика нужно использовать функцию Print

=== Репликатор ===

== Прочее ==
ReplaceAddress(target, address) – Возвращает адрес последней доставки корреспонденции получателю target по адресу address от текущего клиента. При отсутствии такой доставки, возвращает address.

GetPrice –возвращает рассчитанное значение цены, на основе прайс-листа клиента и данных о корреспонденции.

GetKurierByStation(i) – возвращает код курьера, ассоциированного со станцией метро с кодом i.

GetNewNumber – Возвращает не занятый номер единицы корреспонденции в текущем заказе.

==История изменений==

=== Недавние изменения ===
{|
||'''Изменено:'''
|2026.0.0.547 Доработка функций ATTACHPDFTOTEXT и PRINTATTACHPDFPAGE, добавлена возможность указать путь к файлу
|-
||'''Добавлено:'''
|2025.0.0.539 Добавлена поддержка отладчика AttachDebugger
|-
||'''Добавлено:'''
|2025.0.0.534 Добавлена поддержка оператора CASE и класса TFunc
|-
|}

=== Версия 2021.0.0.57 от 18.06.2019 ===
{|
||'''Добавлено:'''
|В объект TExcel добавлен метод ColumnDelete.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция InsertFirmAtt.
|-
||'''Добавлено:'''
||В объект TExcel добавлен метод Align.
|-
||'''Добавлено:'''
|Функция CheckEan
|-
||'''Добавлено:'''
|В объект функцию FillAdvPriceReport добавлены параметры ShowSumPrice,InsertColumns
|-
||'''Добавлено:'''
|В объект TSMS добавлен метод Log.
|-
||'''Добавлено:'''
|Добавлена функция Money.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция ValutaSign.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция GetPolygonByLatLon.
|-
||'''Добавлено:'''
|В объект TTable добавлена функция SetMultiHeader, SetCustomHeader.
|-
||'''Добавлено:'''
|Функция DownloadAttachment
|-
||'''Добавлено:'''
|В функцию SetRowHeight объекта TExcel добавлен параметр cnt.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция AsString.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция SetSize.
|-
||'''Добавлено:'''
|В объект TADO добавлена функция ParseForIn.
|-
||'''Изменено:'''
|В объект TBaseUtils из TBase перенесена функция FillExcelDoc.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция CalcAddressPrice
|-
||'''Изменено:'''
|Все функции класса TBaseSupport перенесены в TBaseUtils. Класс TBaseSupport больше не существует.
|-
||'''Добавлено:'''
|В функции RowInsert и RowDelete объекта TExcel добавлен параметр count.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция SendToMeaSoft
|-
||'''Добавлено:'''
|В объект TBaseUtils функция RecalcSpecialSMA
|-
||'''Добавлено:'''
|Новая функция Reverse
|}

=== Версия 849   22.02.2018 ===

{|
||'''Добавлено:'''
|В функцию TBaseUtils.TownByIndex добавлен параметр PriorityName
|-
||'''Добавлено:'''
|В объекте TBase добавлена функция GetNewPackagePos
|-
||'''Добавлено:'''
|В объекте TSMS доработан метод ExtraResult, добавлен параметр ParamName
|-
||'''Добавлено:'''
|В объект TBase добавлена функция CalcAgentPrice
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateAddressForActDelivery
|-
||'''Изменено:'''
|Функция CalcTownDeliveryDate заменена на CalcDeliveryDate
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateSpecialSMA
|-
||'''Добавлено:'''
|Функция SignatureUrl
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция LoadFromStr.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetPen.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetBrush.
|-
||'''Добавлено:'''
|В объект TPicture добавлена поддержка чтения в формате PNG.
|-
||'''Добавлено:'''
|В функцию TCanvas.DrawPic параметр Mode
|-
||'''Добавлено:'''
|Свойство TPicture.Canvas
|-
||'''Добавлено:'''
|Функция DeleteFile
|}

=== Версия 758   29.03.2017 ===
{|
||'''Добавлено:'''
|Функция GetPolygonByAddress
|-
||'''Добавлено:'''
|Функция ParamsCount
|-
||'''Добавлено:'''
|Объект TZip
|-
||'''Изменено:'''
|Функции CreateEAN и Create128 заменены одной функцией CreateBar, полностью совместимой с Create128, но добавлена поддержка EAN-13 и Interleaved 2-5 (для Почты России). В системе функции оставлены для обратной совместимости, но более не являются документированными и рекомендованными к использованию.
|-
||'''Добавлено:'''
|Параметр text в функцию Cell объекта TExcel
|-
||'''Добавлено:'''
|Функция UrlEncode
|-
||'''Добавлено:'''
|Функция IncDay теперь может принимать параметр count
|-
||'''Добавлено:'''
|Функции FtpGet, FtpPut, TTable.SetCell()
|}

=== Версия 452   26.02.2014 ===

{|
||'''Добавлено:'''
|Функция Time
|-
||'''Добавлено:'''
|Функция FixedIntToStr
|-
||'''Добавлено:'''
|Функция TimePeriod
|-
|'''Добавлено:'''
|В интерпретатор добавлена функция приёма смс - ReceiveSMS
|-
|'''Добавлено:'''
|Функция STR2UTF
|-
|'''Добавлено:'''
|Функция SAVETOFILE
|-
|'''Добавлено:'''
|Функция TExcel.SetSheetName
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "FILESTR"
|-
|'''Добавлено:'''
|Расширены возможности объекта addressrecord в формулах тарифов
|}

=== Версия 308   24.11.2012 ===

{|
|'''Добавлено:'''
|В функции загрузки таблиц из TADO добавлено условие, что поля, названия которых начинаются с "-" не выгружаются. Таким образом можно скрывать служебные поля из результирующего набора.
|-
|'''Добавлено:'''
|Функция TExcel.RowAutoFit
|-
|'''Добавлено:'''
|Функция TExcel.RowInsert
|}

=== Версия 300   01.11.2012 ===

{|
|'''Добавлено:'''
|В объекте TCSVFile добавилась возможность запрашивать значения не только текущей записи через параметр сдвига
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "UPDOWN"
|-
|'''Добавлено:'''
|В интерпретатор добавлен объект TCSVFile
|}

=== Версия 266   14.09.2012 ===

{|
|'''Добавлено:'''
|В интерпретатор добавлена поддержка массивов
|}

=== Версия 265   11.09.2012 ===

{|
|'''Добавлено:'''
|Функция CreateTrans в интерпретатор
|-

Руководство программиста

2026-01-13T17:17:06Z

Sammy: /* Недавние изменения */

== Основные положения ==

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

Как интерпретатор приводит типы:

1. При использовании значения как параметр функции интерпретатор автоматически приводит значение к типу, необходимому функции.

2. При операциях сложения, а также логических операциях, операнды приводятся к строке если хотя бы один из них имеет тип «строка». Например:
3.3+5 -> 8.3
‘3.3’+5 -> ‘3.35’
подобную проблему можно решить принудительно преобразовав тип:
float(‘3.3’)+5 -> 8.3

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

Как работают функции приведения типов:

1. При преобразовании строки к числу: функция «читает» строку до первого символа, не позволяющего создать число с плавающей точкой, при этом разделителем целой и дробной частей может быть как точка так и запятая. Если приведение производится к целочисленному типу, то после этого происходит округление. Например:
float('3.6qwerty735') -> 3.6
int('3.6qwerty735') -> 4

2. При преобразовании к булевому типу ложью считается пустая строка либо число 0, все остальное - истина

3. При преобразовании булевого типа к числу истина преобразуется в 1, ложь – в 0. Такое преобразование позволяет использовать сложение и умножение в качестве логических «ИЛИ» и «И» соответственно:
if((5=5)+(6=7), <a>, [b]) – условие истинно, выполнится код «a».

4. При преобразовании булевого типа к строке сначала происходит преобразование к числу:
(5=5)+'qwerty' -> ‘1qwerty’

== Описание синтаксиса ==

Команды разделяются точкой с запятой. Параметры функций разделяются запятыми. Каждая команда (даже цикл while) является функцией, возвращающей некоторое значение. Результатом выполнения составной команды (последовательности функций, разделенных точкой с запятой), является результат выполнения последней функции. Имена переменных, функций, объектов, а также их свойств и методов не чувствительны к регистру.
Константы: константы бывают целочисленными, дробными и строковыми. Значения целочисленных и дробных констант указываются «как есть» (в этом случае разделитель целой и дробной частей – точка), шестнадцатеричные значения начинаются с символа «$» и, если первая цифра – буква, она упреждается цифрой 0, а строковые – в одинарных кавычках. При этом, если внутри строковой константы встречается символ одинарной кавычки он должен быть задвоен, для указания интерпретатору того, что он не является признаком конца константы.
Операции сравнения: >, <, =, ! - Больше, меньше, равно, не равно соответственно.
Логические операции: + (ИЛИ), * (И).
Арифметические операции: +, -, *, /
Операция конкатенации строк: +

=== Функциональность базового объекта ===

'''SET($a, a)''' – присваивает переменной (1-й параметр) значение второго параметра. При отсутствии переменной – создает ее. Имена переменных должны начинаться с символа «$», а следующий символ не должен быть цифрой. Возвращает новое значение переменной. Функция используется только для задания значений переменных. Не допускается использования для задания значений свойств объектов. Для этого используются соответствующие методы этих объектов.

'''IF(a,b,c)''' или '''IF(a,b)''' – Условный оператор. В первом случае возвращает b, если a истинно (не равно нулю или пустой строке), иначе – c. Во втором случае – возвращает a, если оно истинно, иначе – b.

'''WHILE(a, b)''' – Оператор цикла. Выполняет b пока a истинно:
set($i, 10);
set($sum, 0);
while($i>0, set($sum, $sum+$i); set($i, $i-1));
$sum
Результат – 55

'''FOR($a, b, c, d)''' – Оператор цикла. Выполняет d пока $a последовательно присваиваются значения от b до с включительно:
set($sum, 0);
for($i, 1, 10, set($sum, $sum+$i));
$sum
Результат – 55

'''NEW(ClassName, InstanceName)''' – Создает экземпляр класса ClassName, назначает ему имя InstanceName. Возвращает порядковый номер созданного объекта. Доступ к свойствам и методам объектов осуществляется по имени объекта и имени свойства/метода, разделенным точкой. Именем объекта может быть и пустая строка, тогда доступ к его свойствам и методам будет осуществляться без указания имени, и, в случае совпадения имен свойств и/или методов со стандартными или свойствами/методами других объектов, использоваться будут соответствующие свойства/методы объекта, созданного ранее, а также такой объект невозможно уничтожить до окончания выполнения скрипта. Все объекты созданные во время выполнения скрипта уничтожаются автоматически после окончания его выполнения.

'''FREE(InstanceName)''' – Уничтожает объект с именем InstanceName. Возвращает 0. В случае отсутствия объекта с заданным именем вызывает ошибку.

'''ShowObjects''' – Возвращает список созданных объектов – названия классов и имена.

'''ERROR(message)''' – Вызывает ошибку с текстом message.

'''SHOWMESSAGE(message)''' – Отображает диалоговое окно с текстом message, останавливает выполнение скрипта до закрытия окна пользователем.

'''SimpleAskUser(Message)''' – Выводит диалоговое окно с текстом Message и кнопками «Да» и «Нет». Возвращает 1, если пользователь нажал кнопку «Да», иначе – 0.

'''TRY(a)''' – Выполняет a в «защищенном от ошибки» режиме. Если в процессе выполнения a возникает ошибка, возвращает текст ошибки, иначе – 0 (ложь).

'''REM(….)''' – Код в скобках игнорируется (комментарий).

'''EXEC(FileName, Params, Wait, WindowState)''' – Запускает внешнее приложение FileName с параметрами Params. Если Wait истинно – ожидает завершение процесса. Для WindowState доступны следующие числовые значения:
0 - SW_HIDE
1 - SW_SHOWNORMAL (по-умолчанию)
3 - SW_MAXIMIZE
6 - SW_MINIMIZE
Функция возвращает истину если приложение запущено успешно. Иначе – Ложь.
В случае успеха, при параметре Wait – истина кладет в переменную $LastResult код завершения приложения.

'''CASE''' - Оператор множественного выбора. Позволяет выполнить одно из нескольких действий в зависимости от условий. Синтаксис:
<source>
case(
when(условие1, действие1);
when(условие2, действие2);
...
else(действие_по_умолчанию);
);
</source>

Пример использования:
<source>

set($a, 10);
set($b, 50);

showmessage(
case(
when($a < 5, 50);
when($a < 10, 100);
when($a < 250, 200);
else($a*$b);
)
);
</source>

'''AttachDebugger''' - Команда позволяет подключить открытый [[Отладчик_встроенных_скриптов]] к текущему скрипту. Команда AttachDebugger должна быть '''первой командой''' в скрипте. Добавьте её в самое начало скрипта:

<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Как работает:'''
# При выполнении команды AttachDebugger скрипт останавливается.
# Отладчик автоматически подключается к выполняющемуся скрипту.
# Текст скрипта загружается в редактор отладчика.
# Можно ставить точки останова, просматривать переменные и продолжать отладку.

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Если режим отслеживания не включён, команда `AttachDebugger` игнорируется.
* В режиме отслеживания может работать только один отладчик.
* Команда AttachDebugger должна быть первой командой в скрипте.

=== Строковые функции ===

'''UpCase(s)''' – возвращает строку s в верхнем регистре.

'''LCase(s)''' – возвращает строку s в нижнем регистре.

'''Len(s)''' – возвращает количество символов в строке s.

'''Pos(s, substr [,start])''' – возвращает номер первого символа первого включения подстроки substr в строку s, возвращает 0, если включения подстроки отсутствуют. Параметр start - это позиция старта поиска, не обязательный параметр, по умолчанию равен 1. Поиск не чувствителен к регистру.

'''Param(s, i)''' – возвращает i-й элемент строки s, разделенной запятыми на элементы.

'''ParamsCount(s)''' - возвращает количество элементов строки s, разделенной запятыми на элементы.

'''SetParam(s, p, i)''' – заменяет на значение p i-й элемент строки s, разделенной запятыми на элементы.

'''Left(s, i [,full] )''' – возвращает i первых символов строки s. Параметр i, может быть строкой, тогда он считается разделителем и функция, возвращает строку слева от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Mid(s, i, j)''' - возвращает подстроку из s начиная с i символа и длиной j символов

'''Right(s, i [,full])''' – возвращает i последних символов строки s. Параметр i, может быть строкой, тогда он считается разделителем, функция ищет разделитель с конца строки, и возвращает строку справа от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Reverse(s)''' - возвращает строку s задом-наперед. Полезно например для поиска с конца функций Pos().

'''Char(i)''' – возвращает символ с кодом i.

'''Ord(s)''' – возвращает код первого символа строки s.

'''Replace(s, strFind1, strReplace1, [ strFind2, strReplace2, ... ], [caseInsensetive])''' - возвращает строку s, в которой все включения строк strFind заменены строкой strReplace. Параметры поиска и замены всегда должны быть в паре и их может быть несколько. caseInsensetive - неучитывать регистр, не обязательный параметр, по умолчанию включен.

'''RemSpace(s)''' – возвращает сроку s без начальных и конечных запятых и пробелов, а также начальных точек.

'''SumStr(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''с добавлением валюты'''. Необязательные параметры captions - позволяет изменить название валюты, формат строки может зависеть от текущего языка(посмотреть формат можно в "Справочники"-"Статусы"-"32 Валюты", в разделе "Дополнительная информация"). Language - код языка на котором необходимо вывести сумму прописью. По умолчанию если не обязательные параметры опущены, используются региональные настройки в переменных.

'''NumToStrSimple(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''без валюты'''. Параметры идентичны функции SUMSTR.

'''FullNameToShort(Name)''' – Возвращает фамилию и инициалы по полному ФИО Name.

'''MonthName1(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в именительном падеже.

'''MonthName2(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в родительном падеже.

'''StrForXML(s)''' - Подготавливает строку к парсингу как xml: Если находит в строке подстроку "UTF-8" - перекодирует ее из utf-8 в win-1251, убирает начальный знак вопроса, если такой встречается.

'''FixedIntToStr(i, len[, char])''' - Возвращает целое число i дополненное слева символами char (по-умолчанию - "0") до длины len.

'''Translate(format, [param1, param2, ...])''' - Функция перевода строки format в язык пользователя. Строка format может содержать параметры %s, %d - строка и число соответственно.

'''ExtractFileName(FilePath)''' - возвращает имя файла с расширением из полного пути к файлу FilePath.

====Функции перекодировки====
'''DecodeStr(s, charset)''' - Производит перекодировку строки s в кодировку CP1251. Кодировка строки s должна быть заранее известна и может быть :
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866, UNICODE. Имя кодировки следует передавать в точности без лишних символов.

'''EncodeStr(s, charset)''' - Производит перекодировку строки s в кодировку charset. Кодировка строки s должна быть CP1251, возможны следующие варианты перекодировки:
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Имя кодировки следует передавать в точности без лишних символов. UNICODE не работает с версии 2021, в ней строки по умолчанию в кодировке unicode.

Функции EncodeBase64(s), DecodeBase64(s), UrlEncode(s), UTF8Encode(s), UTF8Decode(s), Str2UTF(s) - устарели, используйте EncodeStr, DecodeStr.

====Транслитерация====

'''Translit(s)''' - транслитерация строки русского текста s латиницей

'''UnTranslit(s)''' - транслитерация строки s с латиницы на русский.

==== Экранирование ====

'''QUOTEDSTR(s)''' – квотирует строку s символом «\» (обратный слеш). Возвращает строку s, помещенную между символами одинарной кавычки, при этом все вхождения в строку s символов: «\», «"» и «'» экранируются квотирующим символом, а символы #0, #10 и #13 заменяются на \0, \n и \r соответственно.

'''SQLFloat(f)''' – Приводит число с плавающей точкой к виду, пригодному для SQL-запроса, т.е. к тексту с разделителем дробной части – точка.

'''FormatTextXML(s)''' - квотирует строку s для использования в XML. Производит замены спец. символов для корректности XML-синтаксиса.

'''FormatTextJSON(s)''' - переводит строку в формат JSON, экранирует служебные символы.

'''FormatTextBlob(s)''' - строка s содержит файл, функция перекодирует переданную строку в байты, используется для заполнения полей формата blob.

====Хеширование ====

'''HMACHash256(key, text)''' - создаёт хэш по алгоритму SHA256 для проверки целостности сообщения, key - секретный ключ, text - хэшируемое сообщение

'''MD5Hash(text)''' - создаёт хеш по алгоритму MD5

'''SignatureUrl(url)''' - Подписывает переданный URL. Функция возвратит переданный URL с добавленным в конце параметром, в котором будет записана подпись.

=== Функции работы с датой и временем ===

'''CurrTime''' – возвращает текущее время

'''CurrDate''' – возвращает текущую дату

'''CurrMillisecond''' - Возвращает количество миллисекунд прошедших с начала текущего года. Используется для точного расчета временных интервалов.

'''Today''' - возвращает текущую дату в числовом формате.

'''Day(dt)''' – возвращает день месяца даты dt.

'''Month(dt)''' – возвращает месяц года даты dt.

'''Year(dt)''' – возвращает год даты dt.

'''FirstDayOfMonth(dt)''' – Возвращает первый день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( FirstDayOfMonth( CurrDate() ) );
'''Полужирное начертание'''
'''LastDayOfMonth(dt)''' – Возвращает последний день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( LastDayOfMonth( CurrDate() ) );

'''DaysInMonth(month, year)''' – Возвращает количество дней в указанном месяце.

'''IncDay(dt, [count=1])''' – Возвращает дату, увеличенную на count дней.

'''SQLDate(dt)''' – Пытается конвертировать dt в дату, вернуть в формате «'YYYY-MM-DD'» (с апострофами), если не удается – возвращает «NULL».

'''SQLDateToDate(dt)''' – Переводит дату из SQL-формата в обычный.

'''DAYSBETWEEN(dt1, dt2)''' – Возвращает количество дней между датами dt1 и dt2. В случае ошибки приведения dt1 или dt2 к дате возвращает -1000.

'''TimeBetween(t1, t2)''' - Возвращает количество минут между временем t1 и t2. Если t1 > t2 то будет показано количество минут между t2 и t1. Параметр t может быть как в формате "HH:MM", так и в числовом. Если один из параметров не удалось привести к числовому типу возвращает -1000.

'''WorkDaysBetween(dt1, dt2, [DecreaseFirstDay=0], [DefaultHolidayVarNum=1])''' - Возвращает количество рабочих дней между датами dt1 и dt2. Параметр DecreaseFirstDay уменьшает dt1 на указанное количество дней (по умолчанию 0). В случае ошибки приведения dt1 или dt2 к дате возвращает -1000. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней(по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''TimePeriod(time1, time2)''' - Оформляет временной период. Возвращаемое значение зависит от наличия значения в параметрах. Возможные варианты: "time1 - time2" , "С time1" , "ДО time2".

'''StrDateToFloat(s, [time=false])''' - Переводит строку с датой s в числовой тип. Если параметр time включен, то в строке s должно быть указано время. Дата должна быть в формате "DD.MM.YYYY", а время "HH:NN". Если строку перевести не удалось возвращает 0

'''IsAWorkDay(dt)''' - Когда день dt является рабочим, возвращает true. Если произошла ошибка приведения даты возвращает -1000.

'''IncWorkDay(dt, [count=1],[DefaultHolidayVarNum=1])''' - Прибавляет count рабочих дней к дате dt. Возвращает дату в числовом формате, если произошла ошибка приведения даты возвращает -1000. По умолчанию параметр count равен 1 и не является обязательным. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней (по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''Sleep'''(n) - Задержка выполнения на n миллисекунд.

=== Функции приведения типов ===

'''INT(v)''' – возвращает значение типа “целое”, приводя вариантное значение v к числовому типу, а затем округляя его. В том числе используется как функция округления.

'''FLOAT(v)''' – возвращает значение типа “число”, приводя вариантное значение v к числовому типу, переводя в число цепочку символов до первого нецифрового символа (либо точки или запятой).

'''STR(v)''' – возвращает значение типа “строка”, приводя вариантное значение v к строковому типу.

'''Date(v)''' – возвращает дату, либо пустую строку, если не удается конвертировать v в дату

'''Time(v)''' – возвращает время, либо пустую строку, если не удается конвертировать v во время. Понимает числовое представление времени.

=== Математические функции ===

'''ROUNDUP(f)''' – округляет число f до ближайшего большего по модулю целого числа.

'''ROUNDDN(f)''' – округляет число f до ближайшего меньшего по модулю целого числа.

'''Money(f, CouldBeEmpty, ZeroFill, MakeSpace)''' - Округляет число f, до двух знаков после запятой. CouldBeEmpty - заменить число меньше 0,0001 на пустую строку. ZeroFill - Следить чтобы после запятой было два знака, если будет один, то добавить ноль. MakeSpace - Разделить разряды пробелом.
''Подсказка: для простого округления используется функция int()''

'''Abs(f)''' - возвращает модуль числа f.

'''Mod(x, y)''' - возвращает остаток от деления целочисленного числа x на целочисленное число y.

=== Константы ===

'''Null''' – Возвращает пустое значение.

'''Да''', '''True''', '''Нет''', '''False''' – константы, соответствующие булевым значениям.

=== Прочие функции ===

SetPhoneParams(CountryCode, TownCode) – Устанавливает глобальные настройки кода телефонных кодов страны и города соответственно. По-умолчанию код страны – 7, код города – 495.

PhonesCount(s) – Возвращает количество корректных телефонных номеров, найденных в строке s.

GetPhone(s[, n]) – Возвращает n-й корректный телефонный номер, найденный в строке s. Нумерация начинается с 1.

GetEmail(s) – Возвращает все корректные адреса email, найденный в строке s, разделенные запятыми (т.е. готовыми к передаче в функцию SendEmail).

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

GenEan(ID, Code) – Формирует штрих-код EAN 13 Состоящий из идентификатора типа сущности ID и кода сущности Code, Выравнивает до 13-ти символов, первый – «2», последний – контрольная сума.

CheckEan(s) - Проверяет строку s, что она является кодом EAN13.

SaveToFile(FileName,s, encoding [, append])- Создает текстовый файл по пути, указанному в FileName (если по указанному пути существует файл с указанным именем, он удаляется и создается новый) и производит запись строки s в созданный текстовый файл. encoding - название кодировки, по умолчанию сохраняет в кодировке ANSI. Доступные названия кодировок: KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Если append = true, то производится дописывание данных в файл, а не перезаписывание (не обязательный, по умолчанию выключен).

StrFromFile(FileName) - Читает файл FileName, возвращает в виде строки. При ошибке чтения вызывает ошибку.

DownloadAttachment(code, [savefilepath, tablename='attachment', fieldBlob='file', fieldLDtime='ldtime', fieldUID='uid']) - Функция выкачивает аттачмент из базы, по внутреннему коду - Code, всегда возвращает содержимое файла в виде строки, а также может сохранить файл по указанному пути в параметре savefilepath. По умолчанию, функция настроена на таблицу attachment. Code - внутренний код вложения, tablename - название таблицы, fieldBlob - название поля с содержимым файла, fieldLDtime - название поля с временем последнего изменения строки (для работы кэша). Функция использует кэш и умеет выкачивать файлы зауженные на внешние серверы (http, ftp,sftp, measoft). Для выкачивания с сервера measoft обязательно необходимо указывать параметр fieldUID.

DeleteFile(FileName) - Удаляет файл FileName с диска, возвращает истину, если операция прошла успешно и ложь - в противном случае.

HTTPPOST(host, PostParams, Proxy, ContentType, HTTPUser, HTTPPass, Method, CustomHeader, Reconnects) - Отправляет HTTP запрос по адресу host с данными PostParams. Proxy - объект Proxy, задающий прокси-сервер (по-умолчанию - пусто - не использовать прокси). ContentType - Заголовок ContentType. По-умолчанию - "application/x-www-form-urlencoded; Charset=UTF-8". HTTPUser и HTTPPass - данные для http-авторизации на сервере. Method - метод отправки запроса, по-умолчанию - "POST". CustomHeader - Дополнительные заголовки HTTP запроса, передается в виде списка параметров через запятую и всегда образуют пару: 1 параметр - название заголовка, 2 параметр - значение. Если значение содержит запятую то его нужно экранировать в двойные кавычки. Reconnects - Количество попыток подключения (по-умолчанию - 2), если больше 100 - это таймаут единственной попытки подключения в миллисекундах.
Функция возвращает ответ сервера. 
''Обратите внимание:'' Для имитации отправки данных html-формы методом POST может понадобиться перед передаваемыми параметрами добавить "Data=".

FTPPUT(host, User, Pass, FileName[, Active]) - Отправляет файл на FTP/SFTP-сервер. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

FTPGET(host, User, Pass, SourceFileName, DestFileName[, Active]) - Загружает файл SourceFileName с FTP/SFTP-сервера, сохраняет его в файл DestFileName. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

GetTempDir - Возвращает путь к временной папке.

ApplicationDir - Возвращает путь к файлу программы.

Interpretate(script) - Интерпретирует скрипт указанный в script. Выполнение происходит в текущем инстансе.

LastHttpError - Выводит последний запрос выполненный с ошибкой в функции HttpPost. Содержит подробную информацию по запросу и ответу.

LastHttpResponse - Выводит последний запрос и ответ от сервера после выполнения Http-запроса в функции HttpPost.

== Объект TExcel ==

Предназначен для доступа к данным документов MS Excel. Требует установленного приложения MS Excel. Для работы без установленного MS Excel предусмотрен объект TDirectExcel.

'''''Ввод данных'''''

LoadFromDB(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Если Headered истинно (по-умолчанию), таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Если TranslateHeader истинно, то заголовки таблицы будут автоматически переведены.

MyDB.Open('select * from kurier');
xl.LoadFromDB(MyDB.Self);
xl.DoNotDestroy(true);
xl.SetVisible(true);

Post2Sheet(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) - Почти полный аналог LoadFromDB. В отличии от LoadFromDB если есть открытый файл, выгрузка данных будет выполнена прямо в него.

OpenFile(aFileName) – Выполняет функции SetFileName и Open.

FileName – Возвращает имя текущего файла.

SetFileName(aFileName) – Задает значение свойства FileName.

Open - Открывает файл с именем, заданным свойством FileName. Если имя файла не задано - создает чистую книгу.

Close – Закрывает текущий файл.

'''''Ячейки'''''

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

Cell(x, y, text) – Возвращает значение ячейки, заданной координатами x, y. Необязательный булевый параметр text, в случае истинности, указывает на необходимость возврата данных с учетом формата ячейки, т.е. то, что пользователь видит на экране. Обратите внимание, что если в ячейке число, и ширина столбца не достаточна для отображения, Excel выводит "#####", что и будет возвращено программе, если text=ИСТИНА. Поэтому перед таким использованием рекомендуется выполнить функцию AutoFit.

SetCell(x, y, v[, x2, y2]) – Устанавливает значение ячейки, заданной координатами x и y, в значение v. Если заданы параметры x2, y2 - объединяет (merge) диапазон ячеек заданных координатами, устанавливает значение объединенной ячейки.

'''''Строки'''''

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

RowAutoFit([y1, y2]) - Устанавливает автоматическую высоту строк. Аргументы y1 и y2 необязательны и если не указаны, то процедура будет выполнена для всей страницы, в ином случае только для строк от y1 до y2.

SetRowHeight(r, h[, cnt]) – Устанавливает высоту cnt строк (по-умолчанию 1) начиная со строки r в h пикселей.

GetRowHeight(r) – Возвращает высоту строки r в пикселях.

RowInsert(i[, count]) - Вставляет count (по-умолчанию - 1) строк НАД строкой с номером i.

RowDelete(i[, count]) - Удаляет count (по-умолчанию - 1) строк начиная с номера i.

'''''Столбцы'''''

ColCount - Возвращает количество столбцов в листе.

AutoFit – Устанавливает автоматическую ширину столбцов.

ColumnDelete(i[, count]) - Удаляет count (по-умолчанию - 1) столбцов начиная с номера i.

SetColWidth (c, w) – Устанавливает ширину столбца c в w пикселей.

GetColWidth (c) – Возвращает ширину столбца c в пикселях.

'''''Листы'''''

SetSheet(No) – Устанавливает номер текущего листа. Если лист с таким номером не существует - он будет создан (и все листы до него). Нумерация начинается с 1.

SetSheetName(Name) - Устанавливает название текущего листа.

SheetsCount – Возвращает количество листов в книге.

CopySheetAfter([SheetFrom[, SheetAfter]]) - Копирует лист SheetFrom (по-умолчанию - текущий), создавая новый лист после листа SheetAfter (по-умолчанию - совпадает с копируемым).

SheetDelete(i) - Удаляет лист с номером i.

'''''Форматирование'''''

Align(x1, y1, x2, y2 [,HAlign, VAlign]) - Устанавливает выравнивание данных в указанном диапазоне. HAlign - горизонтальное выравнивание (0 – прижато влево , 1 – по центру , 2 – прижато вправо), VAlign - Вертикальное выравнивание (0 – прижато к верху , 1 – по центру , 2 – прижато к низу).

WrapText(x1, y1, x2, y2, value) – Устанавливает перенос текста прямоугольника в значение value. Если координаты опущены, или 0 – устанавливает границы всей используемой области. Для Value значение по-умолчанию - true.

NumberFormat(x1, y1, x2, y2, Format) - Устанавливает формат вывода чисел в указанном диапазоне ячеек. Например, если Format='0.00' - числа будут выводиться c обязательными 2 знаками после десятичного разделителя.

SetBorders(x1, y1, x2, y2) – Устанавливает границы прямоугольника. Если координаты опущены, или 0 – устанавливает границы всей используемой области.

SetFont(Font[, x1, y1[, x2, y2]]) - Устанавливает шрифт Font для ячеек диапазона. Можно указать координаты только одной ячейки, можно - вообще не указать, тогда будет использован последний выделенный диапазон. Шрифт задается как обычно: 'Arial, 16, T, T, T', порядок параметров: Имя шрифта, размер, жирное начертание, курсивное начертание, одиночное подчеркивание. Если параметры не заданы, то у текущего шрифта они меняться не будут. Примеры: SetFont('Arial, 10, T, F, F', 1,1) - в ячейке A1 будет установлен шрифт Arial жирным начертанием (не курсив и без подчеркивания). SetFont(', , , T, F', 2,1) - в ячейке B1 будет поменяется только начертание курсив и будет отменено подчеркивание (если оно было).

SaveValuesOnly - убирает формулы на текущей странице и оставляет лишь их результативные статичные значения.

'''''Цвета'''''

SetRowFontColor(Row,Color) - Устанавливает цвет шрифта в строке Row. Color - целое значение (RGB)

SetRowColor(Row,Color) - Устанавливает цвет фона в строке Row. Color - целое значение (RGB)

SetColumnFontColor(Col,Color) - Устанавливает цвет шрифта в столбце Col. Color - целое значение (RGB)

SetColumnColor(Col,Color) - Устанавливает цвет фона в столбце Col. Color - целое значение (RGB)

SetCellFontColor(Row,Col,Color) - Устанавливает цвет шрифта в ячейке с координатами [Row,Col]. Color - целое значение, равное номеру цвета в палитре (ColorIndex,не RGB)

SetCellColor(Row,Col,Color) - Устанавливает цвет фона в ячейке с координатами [Row,Col]. Color - целое значение (RGB)

GetRowFontColor(Row)- Возвращает RGB значение цвета шрифта строки Row

GetRowColor(Row)- Возвращает RGB значение цвета фона строки Row

GetColumnFontColor(Col)- Возвращает RGB значение цвета шрифта столбца Col

GetColumnColor(Col)- Возвращает RGB значение цвета фона столбца Col

GetCellFontColor(Row,Col) - Возвращает номер цвета шрифта в палитре (ColorIndex) в ячейке с координатами [Row,Col]

GetCellColor(Row,Col) - Возвращает RGB значение цвета фона в ячейке с координатами [Row,Col]

'''''Копи-паст'''''

Copy(x1, y1, x2, y2) - Копирует в буфер экселя

Cut(x1, y1, x2, y2) - Вырезает в буфер экселя

Paste(x1, y1) - Вставляет из буфера экселя. Команды copy-paste неразрывны, если что нибудь сделать в промежутке между ними, например вставить значение в ячейку, то копирование сброситься. (Последовательность использования: copy - paste, cut - paste)

PasteStyle(x1, x2, y1, y2) - Вставляет только оформление из буфера экселя (Последовательность использования: Copy - PasteStyle)

'''''Изображения'''''

InsertPicture(TPicture, [x=1, y=1, DispX=0, DispY=0, width=0, height=0]) - Функция вставляет рисунок на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки, width, height (не работает для DirectExcel) - ширина и высота области рисунка в пойнтах-единицах Excel

InsertFirmLogo(FirmCode, [x=1, y=1, DispX=0, DispY=0]) - Функция вставляет логотип фирмы с кодом FirmCode на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки.

'''''Вывод'''''

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки. Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SheetFitPageWidth - устанавливает режим масштабирования печати, чтобы печатная форма помещалась в ширину на один лист.

SetOrientation(value) - Устанавливает ориентацию страницы. True (по-умолчанию) - альбомная (ландшафтная), Ложь - портретная.

PrintOut([copies]) - Печатает текущий лист на принтере по умолчанию. Параметр copies - количество копий, по умолчанию равен 1.

Save(filename) - Сохраняет в файл filename. Если файл существует, в основной системе он будет перезаписан, в других проектах - вызовет ошибку "Файл уже существует".

SetVisible(b) – Устанавливает видимость приложения Excel для пользователя. По-умолчанию – false (не видимо).

DoNotDestroy(b) – При уничтожении объекта TExcel (а он уничтожается, как и все остальные объекты автоматически при завершении выполнения скрипта), приложение Excel уничтожается вместе с ним. DoNotDestroy(true) отключает уничтожение приложения.

'''''Пример использования'''''

new('TExcel', 'myxl');
myxl.OpenFile('c:\asdf.xlsx');
set($sum, 0);
while (myxl.EOF=0,
set($sum, $sum+int(myxl.c));
myxl.next );
$sum

''Возвращает сумму всех числовых данных столбца C файла 'c:\asdf.xlsx'''

== Объект TDirectExcel ==
Объект позволяет работать с файлами Excel напрямую, без установленного пакета MsOffice. Применяется в сервисах и при отсутствии экселя. Он максимально совместим с объектом TExcel, однако некоторые методы могут быть не реализованы.

== Объект TCSVFile ==
Предназначен для доступа к данным документов CSV. Разделителем столбцов является символ точка с запятой ;

Функции:

FileName – Возвращает имя текущего файла.

OpenFile(FileName) – Открывает файл FileName.

LoadFromDB(DB[, Headered=false]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO.

LoadFromText(s) - Загружает таблицу из строки s.

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки.

SaveToFile(Filename) - Сохраняет в файл с именем filename.

== Объект TADO ==

Предназначен для доступа к базам данных.

Функции:
{| class="wikitable"
!Функция
!Описание
|-
|Connect(ConnectionString)
|Подключает к источнику данных. ConnectionString – Строка подключения ADO.
|-
|ConnectMySQL(DBServer, DBPort, DBUser, DBPass, DBName)
|Подключает к базе данных MySQL.
|-
|Open(Query)
|Открывает набор данных выполнив запрос Query.
|-
|FieldByNo(i)
|Возвращает значение поля с номером i. Нумерация полей – с нуля.
|-
|FieldName(i)
|Возвращает имя поля с номером i.
|-
|FieldCount
|Возвращает количество полей.
|-
|RecordCount
|Возвращает количество записей.
|-
|RecNo
|Возвращает номер текущей записи. ''ВНИМАНИЕ! В зависимости от способа подключения к БД нумерация может начинаться как с 0 так и с 1!''
|-
|EOF
|Возвращает признак достижения конца набора данных. Становится истиной когда выполняется команда Next на последней записи.
|-
|Next
|Переход на следующую запись набора.
|-
|First
|Переход на первую запись набора.
|-
|Last
|Переход на последнюю запись набора.
|-
|FieldByName(FieldName)
|Возвращает значение поля по имени. Также возможно указание имени поля как свойства объекта.
|-
|Field(Table, ID, FieldName)
|Возвращает значение поля FieldName записи с кодом ID таблицы Table. Набор данных, если он открыт, при этом не закрывается. Первичный ключ таблицы должен называться «code». Гарантированно работает только с MYSQL!!!
|-
|GetSQLValue(Query)
|Выполняет SQL-запрос. Текст запроса должен начинаться с первого символа строки (перед запросом не должно быть пробелов, переносов строк, комментариев и т.д.). Если запрос Insert – возвращает ID вставленной записи. Если запрос – Update, Delete, Replace, Set, Start, Commit, Rollback – возвращает количество измененных записей (RowsAffected), иначе – Select – значение первого поля первой строки результата как текст.
|-
|FillText(s)
|Возвращает строку s с замененными названиями полей между знаками процента на соответствующие значения текущей записи. Так же в строке возможно использование интерпретируемого кода, заключенного между тегами "<?>" и ">". При интерпретации система сначала производит замену полей с процентами на значения, потом интерпретирует код. ''Внимание! Функция не создает отельный контекст интерпретатора, а использует существующий, в нем доступны все объекты и переменные, вызывающего скрипта.'' Дополнительно автоматически создается объект TSelfADO, подключенный к той же БД, что и контекст, вызвавший функцию, с пустым именем, а так же с именем "dataset".
|-
|Query(Query)
|Синоним GetSQLValue.
|-
|Close
|Закрывает набор данных.
|-
|Self
|Возвращает указатель на подключение к БД для использования в других объектах.
|-
|ParseForIn([FieldName='code'])
|Возвращает через запятую значения всех строк в указанном столбце. По умолчанию, используется столбец с именем code.
|-
|GetSQL
|Для отладки. Возвращает последний SQL запрос переданный в методы Open, Query, GetSQLValue
|-
|ExportExcel
|Для отладки. Выгружает в эксель содержимое датасета. Можно использовать в незнакомом окружении для понимания передаваемых полей в : шаблонах, печатных формах и т.д. Аналог команды %echo% в шаблонах, на случай если она не сработает.
|-
|OnGetText
|Функция подменяет текстовый вывод значения поля при выгрузке в эксель. Первый параметр это имя поля, которое надо подменить. Второй параметр это то что необходимо вывести. Работает только с текстовыми полями.
'''''Пример использования'''''
DB.OnGetText('Зона', IF((DB.FieldByName('-Lat') ! 0) * (DB.FieldByName('-Lon') ! 0),
GetPolygonByLatLon(DB.FieldByName('-Lat'), DB.FieldByName('-Lon'), 'TYPE = 1 AND IFNULL(zone, 0) > 0 AND PRICE = ' + DB.FieldByName('-price'), 'zone')
,
''
));
|}

Пример использования – см. TSelfADO

== Объект TSelfADO ==

Наследник объекта TADO. Служит для подключения к «родной» для программы, в которой выполняется скрипт, базе данных. Обладает всеми свойствами и методами объекта TADO, кроме Connect. Иногда автоматически создается системой для обеспечения простого доступа к базе данных, а также иногда создается системой с уже открытым набором данных для передачи обрабатываемого системой набора данных в скрипт. В этом случае для скрипта недоступны функции Open и Close.

Пример использования:

rem('Копируем данные из "родной" базы данных в базу MSSQL.');
new('TSelfADO', 'MyDB');
new('TADO', 'MSSQL');
MSSQL.Connect('Provider=SQLOLEDB.1;Password=myPassword;Persist Security Info=True;User ID=myUsername;Initial Catalog=myDataBase;Data Source=myServerAddress');
MyDB.Open('select code, name, passport from kurier where code>'+Int(MSSQL.Query('select max(code) from kurier'))+' order by code');
While(MyDB.EOF=0,
MSSQL.Query('insert kurier (code, name, passport) VALUES ('+MyDB.Code+', '+QuotedStr(MyDB.Name)+', '+QuotedStr(MyDB.Passport)+')');
MyDB.Next;
);

== Объект TPrinter ==

Предназначен для доступа к принтерам.

Функции:

BeginDoc – Начинает новый документ.

EndDoc – Закрывает документ

PageHeight – Возвращает высоту страницы в пикселях

PageWidth – Возвращает ширину страницы в пикселях

PageNumber – Возвращает номер текущей страницы документа

Orientation – Возвращает текущую ориентацию страницы (0 – портретная, 1 – ландшафтная)

Printing – Возвращает истину если документ открыт

SetOrientation(Orientation) – Устанавливает ориентацию страницы. При необходимости начинает новый документ, новую страницу.

ShowDialog – Показывает пользовательский диалог печати. Возвращает истину, если пользователь нажал "OK".

NewPage – Начинает новую страницу

Canvas – Предоставляет доступ к объекту TCanvas, связанному с принтером.

PrinterNames – Возвращает список принтеров, установленных в системе, разделенный переносами строк

PrintersCount – Возвращает количество установленных в системе принтеров

SetPrinter(Printer) – Устанавливает текущий принтер. Если передана строка – ищет принтер по названию, иначе – по номеру. Нумерация начинается с 0.

PrintTable(Y, Table) – Выводит на печать таблицу Table типа TTable, начиная с координаты Y. При необходимости таблица печатается на нескольких страницах. Возвращает координату Y конца таблицы.

GetDefaultPrinter - Возвращает имя текущего активного принтера.

SetDefaultPrinter(Printer) – Запоминает предыдущий активный принтер и устанавливает новый текущий принтер. Printer - имя принтера. При необходимости нескольких последовательных вызовов SetDefaultPrinter рекомендуется между вызовами использовать RestoreDefaultPrinter.

RestoreDefaultPrinter - Устанавливает активным принтер, который был текущим перед последним вызовом SetDefaultPrinter.

== Объект TCanvas ==

Предоставляет доступ к холсту объекта для прорисовки изображения.

Функции:

DPIX – Возвращает разрешение холста по горизонтали в точках на дюйм

DPIY – Возвращает разрешение холста по вертикали в точках на дюйм

TextOut(x, y, s[, x1, y1, x2, y2]) – Выводит строку s начиная с точки с координатами x и y. Если указаны параметры x1, y1, x2, y2 – то выводимый текст ограничивается заданным прямоугольником.

TextOutEx(x1, y1, x2, y2, Alignment, Font, s, Indent) – Выводит строку s в прямоугольнике с координатами x1, y1, x2, y2. По горизонтали строка выравнивается в соответствии с Alignment (0 – прижато влево, 1 – вправо, 2 – по центру), по вертикали выравнивается по центру. Используя шрифт Font (см описание ниже). Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату X фактического окончания текста (правой стороны – если строка прижата влево, и левой – в остальных случаях)

MLTextOut(x1, y1, x2, y2, Alignment, VAlignment, Font, s, Heigth, Indent) – Выводит многострочный текст s в прямоугольнике с координатами x1, y1, x2, y2 с переносом по словам. По горизонтали строки выравниваются в соответствии с Alignment, по вертикали – в соответствии с VAlignment (0 – прижато вверх, 1 – по центру, 2 – прижато вниз). Используя шрифт Font (см описание ниже). Heigth – высота строки. Если опущено или равно нулю – высота определяется автоматически в соответствии с выбранным шрифтом. Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату Y фактического окончания текста (нижней границы последней строки текста. ''ВНИМАНИЕ! Функция использует координаты прямоугольника для позиционирования текста, однако она не ограничивает его верхней и нижней границами этого прямоугольника!''

DrawPic(x1, y1, x2, y2, Pic, Style, Alignment, Mode) – Прорисовывает изображение Pic (ссылка на изображение TPicture.Self) в прямоугольник заданный координатами x1-y2. Style – стиль масштабирования. 0 – растянуть изображение до границ прямоугольника не сохраняя пропорции, 1 – вписать изображение в прямоугольник сохраняя пропорции – вероятно, останутся поля по вертикали или горизонтали, 2 – вписать сохраняя пропорции, обрезав при необходимости изображение по вертикали или горизонтали. Alignment – выравнивание по горизонтали. Работает только в случае если style=1 и при растягивании изображения получились вертикальные поля. 0 – разместить по центру, 1 – прижать влево, 2 – прижать вправо. Функция возвращает координату X правой стороны изображения кроме случая, когда Style=1 и Alignment=2 – в этом случае возвращается координата левой стороны изображения. Mode - способ наложения изображения. 0 (по-умолчанию) - копирование как есть. 1 - Наложение операцией AND (применяется для получения эффекта прозрачности изображения), 2 - наложение операцией XOR (Применяется для возможности повторной операцией убрать изображение), 3 - Наложение операцией OR.

FillRect(x1, y1, x2, y2) – Рисует прямоугольник '''без границ''' и закрашивает цветом BrashColor

Rect(x1, y1, x2, y2) – Рисует прямоугольник '''c границами''', задаваемыми текущим пером, и закрашивает цветом BrashColor

SetFont(Font) – Устанавливает шрифт по-умолчанию.

SetPen(Width, Color) - Устанавливает параметры "ручки" - толщину и цвет. Если любой параметр опустить, соответствующее значение не будет изменено.

SetBrush(Color, Style) - Устанавливает параметры заливки - цвет и стиль. Если любой параметр опустить, соответствующее значение не будет изменено. Стили заливки: 0 - сплошная, 1 - отсутствует (прозрачная), 2-7 - различные виды штриховки (горизонтальные, вертикальные, в клеточку и т.д.).

TextHeight(s) – Возвращает высоту текста s в пикселях без учета многострочности, с учетом текущего шрифта.

TextWidth(s) – Возвращает ширину текста s в пикселях без учета многострочности, с учетом текущего шрифта.

Использование шрифта (Font): У объекта TCanvas есть «глобальные» установки шрифта. Однако для некоторых функций возможно указание шрифта, отличающегося от глобального. Параметры шрифта – это текстовая строка, состоящая из 6-ти параметров, разделенных запятыми: Название, размер, жирный, курсив, подчеркнутый, цвет. Например:

'Times New Roman, 8, Y, N, N, 255'

Любой параметр можно опустить, и тогда вместо него будет использовано значение по-умолчанию: шрифт: arial, размер – 10, не жирный, не курсив, не подчеркнутый, цвет – черный. Например: ', 7' – указывает, что по-умолчанию нужно взять все параметры кроме размера шрифта. Также можно вместо всей строки указать тире ('-') или пустую строку, и шрифт будет использоваться «глобальный».

Объект можно создать отдельно, не создавая объект TPrinter. В таком случае объект создастся как ссылка на текущий холст принтера (принтер должен быть запущен и начат новый документ). Такой подход используется в доп. возможности PrintCustomSticker

== Объект TPicture ==

Предоставляет функции для работы с графическими изображениями форматов BMP, GIF, JPEG и PNG, а также для формирования штрих-кодов. Обратите внимание, прозрачность изображений не поддерживается, однако в методе TCanvas.DrawPic есть параметр Mode, призванный создавать эффект прозрачности.

Функции:

LoadFromFile(FileName) – Загружает изображение из файла FileName. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromDB(DB, Query) – Загружает изображение из базы данных. DB – ссылка на подключение к базе данных TADO.Self, Query – текст запроса. Запрос должен вернуть в первом поле первой строки BLOB-поле с изображением, все остальные данные возвращаемые запросом игнорируются. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromStr($s) – Загружает изображение из строки $s. Возвращает истину, если операция прошла успешно, иначе – ложь.

CreateBar(Width, Height, BarCode, Textless, Type) – Формирует штрих-код шириной Width и высотой Height с типом кодирования Type. BarCode – текст штрих-кода. Булево значение Textless указывает, что в штрих-коде не должно быть человеко-читаемых символов если истинно. Type указывает тип кодирования: 0 (по-умолчанию) CODE128, 1 - EAN-13, 2 - Interleaved 2-5, 3-DataMatrix, 4-QRCode.
Штрихкод должен быть: Для EAN-13 цифровым 12 или 13 символов (13-й, контрольная сумма рассчитывается автоматически), для CODE128 - должен иметь состоять из допустимого для этого кодирования набора символов. Для Interleaved - должен состоять из четного числа цифр, контрольная сумма автоматически не рассчитывается. Если для Interleaved кода указано значение из 14-ти знаков, подпись цифр выводится в формате Почты России.
Внимание! Для кодов EAN-13 и Interleaved ширина штрих-кода Width не является точным значением получаемого на выходе изображения. Ширина изображения рассчитывается как максимальное кратное минимально возможной ширине, но не меньше минимально возможной. Конечную ширину можно получить в соответствующем свойстве объекта. Для кода CODE128 штрих-код на выходе может оказаться пустым, если указанной ширины штрих-кода не достаточно для его формирования.
Для кода DataMatrix можно установить режим для печати скрытых символов с кодами 29(GS) и 232(FCN1), которые требуются для формирования Честного Знака. Для этого необходимо в начале строки указать символ "[" и все разделители 01, 21, 91, 92 так же экранировать этими скобками. Должно получиться [01]02900002317701[21]k3LInNbH_oG0Q[91]EE06[92]YXiyKfiHjE4YE8b+YVMC1O5r8VtpplA3AwcCqrcG9Dk= . При формировании кода, включится режим формирования штрих-кода DataMatrix GS1, в начале будет добавлен символ с кодом 232 (FCN1), а потом будут добавлены разделители с кодом 29 (GS)
Функция возвращает 1 в случае успеха, или текст ошибки, если такая произошла.

SetSize(Width, Height) - Устанавливает размер изображения.

AsString([ImageFormat]) - Возвращает изображение в виде строки с двоичными данными. ImageFormat принимает значения 1 - Bitmap (по-умолчанию), 2 - jpeg, 3 - png, 4 - gif.

Width – Возвращает ширину изображения.

Height – Возвращает высоту изображения.

Rotate(Angle) – Поворачивает изображение по часовой стрелке на угол Angle. Угол указывается в градусах и может принимать любые значения.

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

Canvas - ссылка на объект TCanvas холста изображения.

== Объект TTable ==

Предоставляет функции для работы с таблицами. Удобен для печати таблицы на принтере. Алгоритм таков: Загружаем датасет в таблицу, настраиваем ее (шрифты, штрих-коды и т.д.), потом выводим на принтер функцией TPrinter.PrintTable.

Функции:

LoadFromDB(DB) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Заголовок – это первая строка таблицы.

Cell(С, R) – Возвращает значение ячейки таблицы с координатами (C, R). Нумерация строк и столбцов начинается с 1.

SetCell(С, R, Value) – Устанавливает значение ячейки таблицы с координатами (C, R) в Value. Нумерация строк и столбцов начинается с 1.

RowCount – Возвращает количество строк в таблице.

ColCount – Возвращает количество столбцов в таблице.

SetTitleFont(Font) – Задает шрифт заголовка таблицы (первой строки).

SetFont(Font) – Задает шрифт всей таблицы кроме заголовка.

SetColFont(C, Font) - Устанавливает шрифт столбца C.

SetIndent(Indent) – Задает отступ от границы ячейки до текста в процентах от ширины страницы. По-умолчанию значение 0.3

SetWidth(С, Width) – Задает значение ширины столбца C в процентах от ширины страницы.

SetMinRowHeght (Heght) – Задает значение минимальной высоты строки в пикселях.

SetBarCode(Col, Type) - Указывает, что данные из столбца Col должны печататься в виде штрих-кода. Тип штрих-кода - Type. Значение '''"1" - EAN13'''. Для кода EAN13 первая строка данных в ячейке должна иметь вид "тип штрих-кода, номер", например "7, 123" (без кавычек, конечно). В этом случае система сформирует штрих-код: "2700000001233". Первая цифра - всегда 2, далее - указанный тип штрих-кода, нули, чтобы получилось 13 символов, номер, указанный в таблице, и один символ - контрольная сумма. Значение '''"2" - CODE128''' (с версии 734). Данные из первой строки ячейки таблицы печатаются в штрих-коде "как есть". Для всех видов штрих-кода (с версии 734) последующие строки печатаются под штрих-кодом в виде текста.

SetMultiHeader(Active) - Включает печать заголовка при переносе таблицы на несколько страниц. По умолчанию отключено.

SetCustomHeader(script) - Включает печать пользовательского заголовка. Script - это код интерпретатора, который должен печатать заголовок на канву. Печать таблицы может происходить на нескольких листах, по этому скрипт будет вызван для каждого листа. При использовании этого метода, автоматически инициализируются переменные: $TablePageNo - номер страницы, нумерация начинается с нуля; $TableY - координата по оси Y, от которой рисуется заголовок. Чтобы таблица была под заголовком необходимо значение переменной $TableY увеличить на высоту заголовка.

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

Пример:
<?>
NEW('TPrinter', 'Prn');
If(prn.ShowDialog,
NEW('TTable', 'Tbl');
NEW('TSelfADO', 'MyDB');
MyDB.Open('SELECT concat("7", ", ", a.code, "\r\n", a.client_id, "\r\n", a.zakaz, "-", a.number) as "Штрих-код", a.target AS "Заказик", address, phone, vlog, poruch FROM address a order by code desc limit 10');
Tbl.LoadFromDB(MyDB.Self);
Tbl.SetBarcode(1, 1);
Tbl.SetCustomHeader(
if($TablePageNo>0,
Prn.Canvas.TextOut(Prn.Canvas.DPIX*0.1, $TableY, 'Продолжение таблицы');
set($TableY, $TableY + Prn.Canvas.TextHeight('H'));
,0)
);
Prn.BeginDoc;
Prn.PrintTable(0, Tbl.Self);
Prn.EndDoc
, );

== Объект TBaseUtils ==

Предоставляет функции, базирующиеся на БД системы «MEASOFT». По-умолчанию, при создании подключается к основной базе данных модуля, в котором выполняется скрипт, если такая определена контекстом, однако это можно изменить, см SetConnection.

Функции:

'''MakeAddress(s[,town])''' – возвращает значение, полученное путем преобразований адреса s для приведения его к внутреннему формату программы. В процессе преобразования до нескольких раз происходит замена буквосочетаний по таблице замены (ее редактирование доступно по нажатию кнопки «Автозамена» в интерфейсе импорта БД из Excel системы (см. Руководство пользователя)), поиск улиц по базе КЛАДР с точностью до одного знака, и некоторые другие операции, нацеленные на исправление ошибок в написании адреса.

С версии программы 2008.0.0.615, при вызове функции в формулах загрузки реестра, в первую очередь происходит проверка строки s на условия:
* в строке s записано число;
* строка s начинается с "ПВЗ ".
Если одно из этих условий выполняется, то функция пытается установить пункт самовывоза - т.е она сама в загружаемой карточке корреспонденции укажет: адрес ПВЗ, город ПВЗ и установит галку самовывоз. Правила поиска ПВЗ:
* Если s число - считаем его внутренним кодом филиала;
* Если s начинается с "ПВЗ " - Например в адресе передана строка "ПВЗ На Ленинском проспекте", то искать будем филиал с названием "На Ленинском проспекте" который подчиненный, активный, с галкой ПВЗ и в городе town. Если город не указан, то ищем филиал во всех городах, и считаем его найденным если найдем только один филиал.
* Если филиалы найти не удалось, функция makeaddress работает как обычно и выполняет преобразование адреса.

Если адрес не содержит русских букв, только латиница, и курьерская служба находится в одной из стран Россия, Белоруссия, Казахстан или Украина, и город-получатель (второй параметр, town) находится так же в одной из этих стран, функция автоматически делает транслитерацию адреса на русский язык.

''SetConnection(DB) – Подключает объект к базе данных DB, где DB – ссылка на объект TADO.Self.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

''SetTown(Town) – Устанавливает код текущего города (используется в некоторых функциях объекта) в значение Town. По-умолчанию текущий город – 1.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

'''SetIndexLength(Length)''' – Устанавливает длину почтового индекса. По-умолчанию – 6.

'''GetIndex(Address)''' – Возвращает почтовый индекс из адреса.

'''GetStreet(Address)''' - Возвращает улицу до первой запятой.

'''GetHome(Address)''' - Возвращает номер дома до второй запятой, но не более пяти символов.

'''GetKurierByStation(station, Mass, Cash, Date_Putn)'''

'''TownByIndex(Index[, PriorityName][, PriorityCountry])''' – Возвращает код города по индексу. В случае ошибки поиска – код текущего города. Если нашлось несколько населенных пунктов, и указано приоритетное название - выбирается населенный пункт, название которого начинается с PriorityName (если есть).

'''TownByName(Name[,NotNeedCL=False, City=0])''' – Возвращает код города по имени. В случае ошибки поиска – возвратит код текущего города. Если параметр NotNeedCL (параметр не обязательный) установить в TRUE, тогда функция возвратит 0, если город не удалось найти. Параметр City (код региона) позволяет ограничить поиск одной областью (не обязательный, по умолчанию не используется).

'''FillClientInfo(Excel, client, Sheet, Row, Col)''' – Выводит в эксель информацию о клиенте с кодом client на лист sheet начиная со строки row и столбца col.

'''SavePrintFormToFile(FormType, FormNumber)''' - Сохраняет на диске файл печатной формы и возвращает путь к нему

'''CreateTrans(Address[, Store][, Operator][,Correction])''' - Формирует запись для печати кассового чека для корреспонденции с кодом Address, для выбора кассового аппарата используется код склада Store. Если Store не указано - при исполнении в среде клиентского модуля системы использует склад, указанный пользователем в окне [[Настройка параметров рабочего места|"Настройка" - "Параметры"]], в остальных модулях - код текущего склада из [[Настройка глобальных параметров|переменной]] "CL" ("Текущий филиал"). Поле Operator позволяет указать кассира (передается код справочника сотрудников). Если не указан, в основной системе будет использован код авторизованного пользователя, в других модулях - 1.
Поле Correction позволяет указать данные для корректировочного чека, используется в системе Штрих-М. По умолчанию пустая строка. Возвращает идентификаторы записей чеков. Может вернуть пустую строку, если чек создавать не понадобилось, один или несколько кодов через запятую, если создано несколько чеков. В случае ошибки вызывает ошибку, поэтому рекомендуется использовать с функцией Try.

'''CreateReturnTrans(Address)''' - формирует запись для печати чека возврата для корреспонденции с кодом Address. Чек возврата печатается на полную сумму и с теми же атрибутами, что и чек продажи. Возвращает идентификатор записи чека возврата. В случае ошибки вызывает ошибку, поэтому, как и с CreateTrans, рекомендуется использовать с функцией Try.

'''CalcTownDeliveryDays(Source, Mode, TownTo, TownFrom)''' - возвращает количество дней необходимых на доставку отправления, только для межгорода. Source - код клиента, Mode - режим срочности, TownFrom - код города отправителя, TownTo - код города получателя.

'''CalcDeliveryDate(Source, Mode, TownTo, TownFrom, Date_Beg, Time_beg)''' - Возвращает планируемую дату доставки с учетом сроков доставки. Работает при городской и междугородней доставке. Для межгорода сроки доставки берутся из зон. Для городской доставки, из дополнительных параметров статуса (17 статус, 1 параметр в доп. информации) Если рассчитать дату планируемой доставки не удалось, возвращает пустую строку. Параметры: Source - код клиента, Mode - режим срочности, TownTo - город получатель, TownFrom - город отправитель, date_beg - дата заказа (может быть передана строкой в формате DD.MM.YYYY или в числовом), time_beg - время заказа.

'''GenSpecialSMA(DirectExcel, Code)''' - функция для генерации отчета о доставке по акту передачи денег. Первый параметр - указатель на TDirectExcel, второй параметр - код акта передачи денег. АПД выводится на текущий лист объекта TDirectExcel.

'''CreateSpecialSMA(ClientCode, DateTo)''' - Функция создает исходящий акт передачи денег (АПД). Требует ClientCode - код клиента, DateTo - дату акта. Функция возвращает коды созданных актов. Если возвращаемых параметров два, значит функция пыталась создать два АПД: первым, идет код АПД с наличной оплатой, а вторым с безналичной. Примеры возвращаемого результата: '0'- акт не был создан, отсутствуют корреспонденции; '124' - код созданного акта; '0,0' - пытались создать два акта, но отсутствуют данные; '4556,0' - создан только наличный АПД; '0,445' - создан только безнал.; '4556,445' - созданы нал. и безнал.

'''CreateAddressForActDelivery(ActCode, [DeliveryDateMode=0, Delivery=True])''' - Функция создает корреспонденцию на доставку акта. ActCode - код акта; DeliveryDateMode: 0 - установить план. дату доставки текущим рабочим днем, 1 - установить план. дату доставки следующим рабочим днем, 2 - установить план. дату доставки равной планируемой дате оплаты АПД; Delivery - создать корр. на доставку АПД или создать корреспонденцию на забор АПД (по умолчанию, доставка АПД). Работа функции может быть изменена системной доп. возможностью OnCreateAddressForActDelivery.

'''CreateAddressTransferAct(ClientCode, Store, DateTo, [AdditionalParam])''' - Функция создает исходящий акт передачи корреспонденции (АПК). Требует ClientCode - код клиента, Store - код филиала, для которого будет создан акт, DateTo - дату, до которой в акт попадут возвраты, AdditionalParam - дополнительный строковый параметр для передачи в системную доп. возможность ExceptionsForAPK, позволяющий отобрать в акт, например, только полные возвраты. Возвращает код созданного акта. ВНИМАНИЕ: при создании АПК используется системная функция ExceptionsForAPK. Если в ней используются интерактивные функции (вывод сообщений, диалоговые окна, выполнение скриптов), то акт сформирован не будет, а функция CREATEADDRESSTRANSFERACT вернет ошибку.

'''GetPolygonByAddress(Address, TownCode, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попал адрес. Если полигон найти не удалось, функция возвратит пустую строку. Address - адрес корреспонденции текстом; TownCode - код города; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByAddress(addressrecord.address, if((addressrecord.number=0)*(addressrecord.strbarcode=<nowiki>''</nowiki>), addressrecord.townfrom, addressrecord.townto), '`schema`=1') - пытаемся найти вхождение адреса в полигоны 1 схемы, при выборе города учитывается корр. на забор, у нее нужно использовать город-отправитель (а для обычной корр. нужен город-получатель).

'''GetPolygonByLatLon(Lat, Lon, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попали GPS координаты. Если полигон найти не удалось, функция возвратит пустую строку. Lat - широта текстом; Lon - долгота текстом; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByLatLon('55.769064','37.590713','zone is not null and price=0') - пытаемся найти вхождение координат в полигоны, где задана зона, для всех клиентских и курьерских зон.

'''GetLatLonByAddress(AddressText, TownCode)''' - возвращает географические координаты вида lat,lon указанного в AddressText адреса. Поиск производится в городе, имеющем код TownCode в таблице Town.

'''GetRouteCode(AddressText, TownCode, LatLon[, Lon])''' - для адреса AddressText в городе с кодом TownCode (из таблицы Town) по географическим координатам lat, lon возвращает код роута (записи, хранящей координаты адреса в городе). Если роут не найден (для адреса в городе не найдено записи с указанными координатами) - создает новый роут и возвращает его код, если роут найден (был создан ранее) - обновляет у роута координаты. Если параметр Lon задан, то параметр LatLon должен содержать одну координату, иначе LatLon должен содержать строку вида 'lat, lon'.
В случае ошибки возвращает Null.

Пример: 
Set($res, GetRouteCode(address, townto, '55.114034, 36.592397')); 
Set($res, GetRouteCode('Троицк, Полковника милиции Курочкина ул., 11', 1, '37.467446, 55.740537')); 
Set($res, GetRouteCode('Обнинск, Маркса пр., 20', TownByName('Обнинск'), 55.114034, 36.592397));

'''CalcAgentPrice(AddressCode, AgentCode, TownFrom, TownTo, Mode, [, Count=1])''' - функция возвращает стоимость доставки рассчитанную по тарифу агента. AddressCode - код адреса, AgenCode - код филиала (агента), TownFrom - код города отправителя, TownTo - код города получателя, Mode - режим срочности, count - тарифная сетку от указанного количества отправлений (по умолчанию 1)

'''SetAddrKol_vo(address, getkol_vo)''' - функция делает прием корреспонденции в текущем ответственном филиале. address - внутренний код адреса, getkol_vo - количество принимаемых мест, может принимать значения: "kol_vo" - принять все места, "getKol_vo+1" - принять еще одно место, "число" - сделать количество принятых мест равным указанному числу.

'''CalcClientCnt(client_code, date, is_intown [, date_put=CurrDate(), skipajust=false])''' - функция расчета количество доставленных корреспонденций у клиента с кодом client_code за предыдущий месяц от даты date (Или за текущий месяц, подробнее смотри переменную UseCurrentMonthCount) среди внутригородских (is_intown = true) либо междугородних (is_intown = false) корреспонденций, date_put - дата доставки (для альтернативного способа подсчета, включаемого переменной UseDatePutForCalcCnt), skipajust - не учитывать принудительно введенные количества (таблица priceclientadjust типы записей 0 и 1).

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset._self".
Описание некоторых полей датасета:
pmoney - процент от суммы;
pmoneycard - процент от суммы при оплате картой;
pricecode - код прайса (таблица Price) ;
distarea - район метро получателя (актуально при отключённом едином районировании, как правило район от 200 до 299 является признаком области);
region - признак области при включенном едином районировании;
distareaFrom и regionFrom - аналог distarea, region только для отправителя;
pcncode - код записи таблицы pricecnt "количество от";
Запрос содержит поля таблицы pricelinesnew - начальная стоимость по тарифной сетки, найденные без учета массы,только по типу срочности и режиму.
Запрос содержит поля таблицы price.

*addressrecord - ссылка на объектную модель карточки корреспонденции, следует использовать уже созданную addressrecord._self
*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*type - тип корреспонденции;
*mode - режим доставки;
*wait - количество минут ожидания (не учитывается при доп. услугах, есть системная услуга "ожидание");
*mass - масса отправления;
*rur - сумма передаваемых денег (не учитывается при доп. услугах, есть системная услуга "процент от суммы");
*inshprice - сумма страховки (не учитывается при доп. услугах, есть системная услуга "процент от объявленной стоимости");
*distance - расстояние до места доставки, обычно поле заполняется при доставке в область (регион в едино районировании). Дополнительная наценка к стоимости доставки;
*forward - направление доставки: true - туда; false - обратно;
*Collection - признак заборной корреспонденции: true - забор, false - доставка (В тарифе есть возможность указать стоимость для забора);
*TownFrom - код города отправителя;
*TownTo - код города получателя.

В тарифе есть возможность указать формулу, которая может влиять на базовый расчет. Формула может объявить служебные переменные, которые:
*$FormulaReplace - если true – возвращаемое значение полностью заменяет базовый расчет;
*$FormulaKoeff - коэффициент на который будет помножена базовая стоимость.
Также внутри формулы объявлены следующие объекты dataset, addressrecord и переменные:
*$ForceIntown - Переменная становится истиной, если междугородний расчет был отменен, т.к. адрес попал в нарисованную зону на карте.
*а также: $forward, $distance, $Count, $Collection, $Wait, $FormulaKoeff, $PriceCode - описание есть выше.

Для направления "туда", Функция GetBasePrice вызывается через доп. услугу "База" (при включенных доп. услугах), для направления "Обратно" всегда вызывается напрямую (т.к. доп. услуги работают только в для направления "туда").
На расчет этой функции влияют следующие переменные: "Финансы" -> "Расчет стоимости по адресу", "Финансы" -> "Зона клиента по умолчанию", "Финансы" -> "Подсчет кол-ва отправлений за месяц".

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset.self".

*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*tp - тип корреспонденции;
*mode - режим доставки;
*mass - масса отправления;
*TownFrom - код города отправителя;
*TownTo - код города получателя.

'''CalcAddressPrice(AddressCode, [,ZakazCount])''' - полностью пересчитывает стоимость доставки корреспонденции по тарифу клиента. AddressCode - внутренний код адреса, ZakazCount - не обязательный параметр, кол-во заказов от клиента.

'''GetStationCode(s [,town])''' – возвращает код станции метро, ассоциированный в системе с адресом s. В случае невозможности идентифицировать станцию метро – возвращает 0.
Когда включено районирование по карте, необходим второй параметр "town" - код города в котором нужно искать адрес. Возвращает код района если удалось его найти; код станции меж-города - если адрес удалось геокодировать, но район не нашли; код 0 - когда не удалось геокодировать адрес.

'''RecalcSpecialSMA(ActCode)''' - пересчитать акт передачи денег (АПД). Также, у корреспонденций входящих в АПД будет пересчитана стоимость доставки. Для Входящего АПД сумма акта не пересчитывается. Параметр ActCode - внутренний код акта, коды можно перечислять через запятую.

'''UserCode''' - Возвращает код текущего пользователя из таблицы «Пользователи» (users).

'''UserName''' - Возвращает имя текущего пользователя из таблицы «Пользователи» (users).

'''UserPass''' - Возвращает пароль текущего пользователя.

'''UserBaseCode''' – Возвращает код текущего пользователя из таблицы «Сотрудники» (kurier).

'''UserEmail''' - Возвращает e-mail текущего пользователя.

'''CurrentTown''' – Возвращает код текущего города (из таблицы town).

'''CurrentCity''' – Возвращает код текущего региона (из таблицы city).

'''CurrentLocation''' – Возвращает код текущего филиала (из таблицы store).

'''FromEmailStr''' - строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

'''FillExcelDoc'''(Excel, Dataset, FormType, FormNumber,Print,[printer]) - Выполняет указанную печатную форму в объекте excel. Excel объект можно не указывать, тогда функция сама создаст объект экселя и разрушит его, полезно когда книгу
нужно распечатать или отправить по email (на листе данных в ячейке 1,1 укажите ключевое слово email). Dataset объект с данными для скрипта в печатной форме, может быть null. Dataset передавать можно так db.self, тогда переданный dataset внутри печатной формы будет доступен по имени dataset. Print - печатает книгу на принтере, после печати объект excel разрушается, при использовании параметра не указываете объект excel. Printer - имя принтера, на котором печатать (по умолчанию пустая строка, что означает "печатать на принтере по умолчанию"). Например:

new('TExcel', 'excel');
FillExcelDoc(excel.self, null, 12, 1);
excel.DoNotDestroy(true);
excel.SetVisible(true);
''Покажет эксель с выполненной печатной формой''

'''ValutaSign''' – Возвращает название валюты для суммы.

'''SendToMeasoft(xml)''' - Отправляет запрос в клиентское API Measoft. Автоматически добавляет начальный "<?xml version="1.0" encoding="utf-8"?>".

'''InsertFirmAtt(excel, sheet, firmcode)''' - Вставляем на лист эксель по коду фирмы: печать, подпись, подпись бухгалтера, логотип. Тэги <STAMP>, <DIR>, <BUH>, <LOGO> соответственно. После тега можно указать размеры изображения в символах Microsoft Excel. Формат записи: <STAMP> 16, 16

'''PreCalcSalary(kurier, addressCodes)''' - Рассчитывает предварительную зарплату. Kurier - код курьера, используется для определения тарифа. addressCodes - коды адресов, через запятую для которых необходимо посчитать зарплату. Результаты расчета будут записаны в таблицу kurierpaydetail, так как расчет предварительный то записи не будут прикреплены к конкретному начислению.

select a.code, kpd.price as "туда", kpd2.price as "обратно" from address a
left join kurierpaydetail kpd on kpd.sourcetable=3 and kpd.sourcecode=a.code and kpd.rectype = 1
left join kurierpaydetail kpd2 on kpd2.sourcetable=3 and kpd2.sourcecode=a.code and kpd2.rectype = 2
where a.code in (...)

'''CalcSalary(DateTo, [Filter=0, KurierCode = 0, ManagerCode = 0])''' - Полный расчет зарплаты курьерам. DateTo - дата до которой создается начисление. Условия отбора курьеров для начисления. Filter - роль сотрудника: 0 - Все, 1 - курьеры, 2 - менеджеры; KurierCode - код курьера, ограничить расчет зарплаты одним курьером;ManagerCode - код курьера, ограничить расчет зарплаты курьерами указанного менеджера. Внимание фильтры Filter, KurierCode и ManagerCode накладываются друг на друга. Результатом функции является SubSQL с информацией по созданным начислениям.
поля ответа: код курьера, код менеджера, начислено, бонусы, штрафы, аванс, итого;
select kurier, manager, profit, bonus, shtraf, prepay, total [union select ...]

'''SelDistAddr(s)''' – Возвращает строку для вставки в select запрос, для вывода поля с упрощенным адресом. Принимает один необязательный строковый параметр - алиас таблицы из которой будет упрощаться поле address, по умолчанию "a"

'''VoiceReadStr(str)''' – Озвучивает фразу str голосовым уведомлением доступными словами из базы. Может содержать тег "{break_off}" для того, чтобы сделать эту фразу не пропускаемой в очереди воспроизведения.

'''CalcStorageCost(ClientCodes, DateFrom, DateTo, NeedReport[, Store])''' – рассчитывает стоимость хранения на складе для выбранных клиентов (ClientCodes - коды клиентов через запятую), в период дат с DateFrom до DateTo, с прикреплением к корреспонденции отчета в зависимости от выставленного параметра NeedReport. Может содержать параметр Store - код филиала, по умолчанию пустой (расчет выполняется для всех филиалов). Возвращает коды созданных корреспонденций через запятую.

'''WriteOut(DocId, ItemId, Date, Cnt[, BC])''' – производит списание товара со склада. DocId - код (docs.code) документа списания, ItemId - код товара (item.code), Date - дата операции, Cnt - количество списываемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер. Если указан BC, то параметр ItemId игнорируется и поиск номенклатуры происходит исключительно по штрих-коду. В случае успеха, функция возвращает строку вида: код номенклатуры, списанное кол-во.

'''IncomePurch(DocId, ItemId, Date, Cnt[, BC, Location = CurrentLocation])''' – производит приход товара на склад. DocId - код (docs.code) приходной накладной, ItemId - код товара (item.code), Date - дата операции, Cnt - количество приходуемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер, Location - код склада (store.code). В случае успеха, функция возвращает строку вида: код номенклатуры, введенное кол-во.

'''CreateLedgerDoc(Date, Client, UserCode, Type[, ExtNumber, Message])''' - создает складской документ и возвращает код этого документа. Date - дата документа. Client - код клиента. UserCode - код пользователя, создавшего документ. Type - тип документа (statetype = 13). ExtNumber - номер у поставщика для документов прихода и расхода. Message - комментарий к документу. Последние два аргумента не обязательные и могут быть пустыми.

== Объект TINIFile ==

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

Функции:

IniParam(s[,section='common']) – Существует только если имя экземпляра объекта пустое. Возвращает значение параметра s ini-файла секции «common», изменить секцию можно не обязательным параметром section. В случае отсутствия параметра в файле возвращает пустую строку.

Param(s) – Синоним IniParam с тем отличием, что существует только если имя объекта непустое.

SetText(s) - Загружает ini файл из строки s. Если в файле нет секции «common», то принудительно объявляет ее в начале.

== Объект TSMS ==

Предназначен для отправки SMS, а также проверки статуса их доставки.

Функции:

SetProxy(Server, Port, User, Pass) - Устанавливает настройки прокси-сервера.

Connect(Provider, Host, User, Pass, SenderName, SMSPrefix) – Подключает объект к провайдеру provider, используя адрес Host, имя пользователя User и пароль Pass. Значение SMSPrefix предназначено для того, чтобы провайдер мог различить сообщения от разных филиалов, если этими филиалами используется одно подключение. Если необходимости разделять сообщения нет - значение SMSPrefix можно не указывать.
Для провайдера доступны значения 'mirsms', 'sms16', 'websms', 'epochta', 'zanzara', 'SMSManager', 'f1sms', 'BitCall', 'mirsmsGET', 'AMD' и другие, либо можно указать числовые значения номера протокола, от 1 до <rspoiler text="20">Набор провайдеров все время дополняется, количество и номера можно смотреть в Справочники - Переменные - Подключения - SMS</rspoiler> соответственно. Эти значения соответствуют значениям переменной SMSProtocol таблицы "Value".

SendSMS(Phone, Text, [ID]) – Отправляет SMS с текстом Text на телефон Phone. Для некоторых провайдеров необходим уникальный идентификатор сообщения ID (для провайдера iVoice - идентификатор сценария (кампании)). Возвращает ID провайдера для последующей проверки статуса доставки.

CheckSMS(ProviderID) – Проверяет состояние доставки сообщения с идентификатором ProviderID. Возвращает: 0 – доставляется, 1 – успешно доставлено, 2 – не доставлено.

ReceiveSMS(InboxID, DateFrom, DateTo, NewOnly) - Получает входящие SMS, с ящика InboxID (идентификатор выдаётся провайдером). DateFrom, DateTo - задается временной интервал в котором были приняты сообщения(формат 08.04.2013 18:00:00 'DD.MM.YYYY HH:NN:SS'). Чтобы получать только новые сообщение поле NewOnly должно быть True. Возвращает XML с сообщениями.

ExtraResult([ParamName='']) - Вызывается после CheckSMS, возвращает дополнительную информацию по последнему статусу смс. В настоящее время работает только для провайдеров BitCall и iVoice. Для BitCall по умолчанию возвращает кнопки, нажатые абонентом во время работы с голосовым меню. Если в paramname указать 'IdentifyText' то будет возвращен JSON с ответами абонента на заданные вопросы(используется в случае звонков с индивидуальным сценарием). Для iVoice по умолчанию подразумевается параметр 'response', при этом будет возвращен JSON с ответами абонента на заданные вопросы (в зависимости от сценария)

Log - Возвращает последний HTTP запрос и ответ от сервера смс.

== Объект TXML ==

Предназачен для парсинга XML-данных.

Функции:

SetText(S) – Задает текст XML документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию. Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

AttribCount – Возвращает количество атрибутов текущего элемента.

AttribName(i) – Возвращает имя атрибута с номером i.

Attrib(V) – Ищет атрибут и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

Reset – Делает текущим корневой элемент, возвращает его значение.

== Объект TJSON ==

Предназачен для парсинга JSON-данных.

Функции:

SetText(S) – Задает текст JSON документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Можно проверять наличие элементов, если элемента нет, вернется пустая строка.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

Reset – Делает текущим корневой элемент, возвращает его значение.

isArray - Возвращает true, если текущий элемент является массивом (доступ к дочерним элементам возможен только по индексу, нумерация элементов начинается с нуля)

==Объект TZip==
Предназначен для работы с Zip архивом.

SetZip(s) - Загружает архив в объект из строки s;

GetZip - Возвращает архив в виде строки;

AddFromFile(SrcPath, ZipPath) - Добавляет файл SrcPath в архив и располагает его по пути ZipPath. ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

AddFromStr(Data, /*ZipPath*/) - '''параметр ZipPath временно не работает'''. Добавляет файл из строки Data в архив и располагает его по пути ZipPath. -ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

LoadFromFile(path) - Загружает архив из файла path;

SaveToFile(path) - Сохраняет архив в файл path;

Count - Возвращает кол-во файлов в архиве;

DataByIndex(index) - Возвращает распакованный файл в виде строки. Index - номер файла в архиве;

DataByName(ZipPath) - Возвращает распакованный файл в виде строки. ZipPath - путь к файлу в архиве, может содержать каталоги;

FileName(index) - По номеру файла, функция возвращает полный путь файла в архиве.

==Объект TBase==

'''Функции общего назначения''':

'''ExecSimpleScript(Caption, Text)''' - Выполняет скрипт "Дополнительных возможностей". Возвращаемые значения, введенные пользователем устанавливает в переменные $scriptvar1..$scriptvarN, Значения кодов списочных переменных - в переменных $scriptvar1codes..$scriptvarNcodes. Функция возвращает истину, если пользователь нажал "OK" в диалоговом окне.

'''FillAdvPriceReport(Excel, AddressCodes, StartLine, StartCol, [ShowSumPrice,InsertColumns,ShowAll])''' - добавляет отчёт по дополнительным услугам. В AddressCodes - указаны коды адресов через запятую, каждый код это отдельная строка отчета. Адреса будут показаны в порядке перечисления их в AddressCodes. Если в отчет нужно добавить пустую строку, то можно указать код адреса -1000. StartLine, StartCol - верхний левый угол выгружаемой таблицы. ShowSumPrice - добавить столбец итоговый столбец с суммой всех услуг, по умолчанию выключено. InsertColumns - раздвинуть таблицу перед вставкой отчета, позволяет встраивать отчет посередине выгрузки, по умолчанию выключено. ShowAll - показать все дополнительные услуги, по умолчанию false и показывает только услуги с начислениями. Функция возвращает количество использованных столбцов.

'''PrintSticker(Codes, [ToBoxes=False])'''

'''PrintBlanc(Codes, BlancNumber)''' - печатать форму из раздела "Заполнить бланк". Codes - коды корреспонденций, BlancNumber - номер формы из раздела "Бланки для корреспонденции" (3)

'''GetItemByName(Name)'''

'''GetA4Printer''' - возвращает имя принтера выбранного для печати документов

'''GetStickerPrinter''' - возвращает имя принтера выбранного для печати стикеров

'''GetDuplexPrinter''' - возвращает имя принтера выбранного для двусторонней печати, если принтер не выбран, возвращает пустую строку

'''PrintAttachPDFPage(Code, FileName, Page, Printer)''' - печатает страницу из вложенного файла PDF. Code - код вложения (attachment) или путь к файлу, Page - номер страницы, Printer - 0 = принтер A4, 1 = принтер этикеток.

'''AttachPDFToText(Code, [TextFileName])''' - преобразует файл PDF из вложений в текст. Code - код вложения (attachment) или путь к файлу, TextFileName - имя текстового файла, в который записывается результат (если не указан, используется временный файл). Возвращает текст в виде строки.

'''GhostScript(GScript, Code)''' — функция для выполнения консольных команд утилиты [https://ghostscript.readthedocs.io/en/latest/Use.html ghostscript]. Где, GScript — строка с командами Ghostscript; Code — код вложения или путь к PDF-файлу, предназначенному для обработки. В командах доступен специальный тег %MeasoftInFile%, который автоматически заменяется на путь к предварительно загруженному файлу (Code). Если в команде необходимо указать путь для сохранения результата обработки, используйте тег %MeasoftOutFile%. В этом случае функция на основании параметра Code автоматически сформирует имя временного выходного файла. После успешного выполнения команд функция возвращает путь к сгенерированному выходному файлу - %MeasoftOutFile%.

'''GetActiveForm([SkipFormName])''' - возвращает код активной формы в программе где происходит сканирование. SkipFormName - не обязательны параметр, имя формы которую нужно пропустить при определении интерфейса.
'''Список интерфейсов''':
0 - неопределенный;
1 - прием корреспонденции на склад;
2 - АПД;
3 - комплектация адресов (ShelfingForm);
4 - доска приема;
9 - вкладка «Манифесты»;
10 - Инвентаризация корреспонденции;
11 - АПК;
12 - вкладка «Адреса»;
13 - вкладка «Выдача»;
14 - вкладка «Склад»;
15 - Список номенклатуры;
16 - Инвентаризация склада;
17 - Приходная накладная;
18 - Списание товара;
19 - Карточка корреспонденции.

'''AddAddressScanLog(Code[, StrBarCode, IsManual, FromInterface, ExtraInfo])''' - добавляет событие сканирование для корреспонденции с кодом Code. Необязательные параметры: StrBarCode - сканируемый ШК корреспонденции (по умолчанию пустой), IsManual - галка ручного сканирования (по умолчанию false), FromInterface - код интерфейса сканирования (StateType=81, по умолчанию 0 - неопределенный), ExtraInfo - текстовый комментарий события.

'''RuleName(alias)''' - Выдает полный путь в дерева прав по псевдониму права.

'''ShowText(Caption:string, Value:string)''' - показывает пользователю окно с заголовком Caption и с многострочным полем со значением Value. Может быть полезен при отображении логов выполненной операции.

'''ShowScanError(msg [, Speek, Color, Abort])''' - выдает пользователю окно с текстом msg блокируя последующие действия сканирования. Если Speek - истинно, то сообщение проговаривается голосовым движком, по умолчанию выключено. Color - целочисленное число цвета, в который будет окрашен фон сообщения (по умолчанию = -1, стандартный). Abort - прервать выполнение скрипта, не показывая ошибку.

'''CheckRule(alias)''' - функция проверки разрешения у текущего пользователя системы, alias - псевдоним права. Возвращает 1, если право есть и 0, если права нет.
Пример: if(CheckRule('RSE'), ShowMessage('У пользователя есть право изменять счета'), ShowMessage('У пользователя нет права изменять счета'));

'''GetKurierMoney(KurierCode, DateEnd, NonCash)''' - возвращает баланс курьера с кодом KurierCode на дату DateEnd. NonCash - булевый флаг, если истинно, то будет рассчитан безнальный баланс;

'''Функции, работающие только в импорте БД из эксель:'''

ReplaceAddress

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

GetPrice

GetNewNumber - используется при импорте реестра, возвращает номер конверта в загружаемом заказе

GetNewPos - используется при импорте реестра, возвращает порядковый номер вложения

GetNewPackagePos- используется при импорте реестра, возвращает порядковый номер места

Zakaz - возвращает номер заказа куда происходит импорт реестра

addresscode - используется при импорте реестра, код созданного адреса

Source - код заказчика

ClientTown - Узнаем город клиента, через филиал с которым он работает. Сам клиент берется из заказа указанного в окне "Импорт БД из Excel".

== Объект TFieldObject ==
Создается только автоматически. Объект для доступа к записям, используется в картах и дополнительных услугах (addressrecord) и событиях карточки корреспонденции (fieldlist). Методы объекта:

'''_GetTableInfo''' - возвращает данные о полях и примеры данных объекта.

'''_Self''' - возвращает ссылку на объект.

'''_Set(fieldname, fieldvalue [, DoUpdateForm])''' - Если базовый объект строка. Устаналивает для поля fieldname значение fieldvalue. DoUpdateForm по уолчанию false, если указать true то обновление поля будет не только в объекте но и пользовательском интерфейсе. Обновление работает только в карточке корреспнденции для ограниченного набора полей: vlog, mode, type, date_put, time_put, message, kurier, state1.

'''_Set(keyfield, keyvalue, filed, value)''' - Если базовый объект таблица (addressrecord.boxes). Работает перегруженная версия метода _set, cначала происходит поиск строки по ключу, далее меняется значение указанного столбца. keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Пример, отключение услуги база:

addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

== Объект TMessage ==
Создается только автоматически. Объект используется для скриптовой обработки письма в [https://wiki.courierexe.ru/index.php/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F_%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8#.D0.98.D0.BC.D0.BF.D0.BE.D1.80.D1.82_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85| заданиях импорта данных]. В себе содержит текст письма в очищенном формате и оригинальном формате HTML, отправитель письма, тему письма, дата получения и список прикрепленных файлов.

'''Message.Text''' - возвращает очищенный от HTML-тегов текст письма.

'''Message.HTMLText''' - возвращает оригинальный текст письма со всеми HTML-тегами.

'''Message.Sender''' - возвращает email-адрес отправителя письма.

'''Message.AttachmentsCount''' - возвращает количество вложенных файлов.

'''Message.DateTime''' - возвращает дату и время получения письма.

'''Message.Subject''' - возвращает тему письма.

'''Message.GetAttachmentDataString(Number)''' - возвращает вложенный файл под номером Number в виде строки.

'''Message.GetAttachmentName(Number)''' - возвращает имя вложенного файла под номером Number.

== Объект TStringList ==
Может использоваться для построчной обработки многостраничных файлов либо для организации текстовых данных. Номер строк начинается с 0.
Имеет следующий функционал:

'''Count''' - возвращает количество строк в списке.

'''Add(Value:string)''' - добавляет значение Value в конец списка.

'''SetText(Value:string)''' - устанавливает значение списка в значение Value.

'''Insert(Number:integer, Value:string)''' - добавляет строку Value в позицию Number.

'''Delete(Number:integer)''' - удаляет строку из списка в позиции Number.

'''Clear''' - очищает элементы списка.

'''LoadFromFile(Path:string)''' - загружает текстовый файл по пути Path.

'''Strings(Number:integer)''' - возвращает строку с номером Number.

'''SetString(Number:integer, Value:string)''' - устанавливает значение строки с номером Number в значение Value.

'''Text''' - возвращает полный список строк в виде текста.

'''CommaText([Quoted:boolean])''' - возвращает список значений через запятую. Если Quoted = true, то квотирует элементы списка. По умолчанию равен false.

'''SetCommaText(Value: string)''' - разбивает значение Value на отдельные строки и кладет в список. Разделитель - запятые.

'''IndexOf(Value:string)''' - ищет значение Value среди элементов списка и если находит, то возвращает номер строки. Возвращает -1 если значение не было найдено.

'''Sorted(Value:boolean)''' - устанавливает флаг отсортированности списка в Value. Если Value = true, то сразу же его сортирует. По умолчанию Value = false.

'''Exchange(Pos1:integer, Pos2:integer)''' - меняет элементы списка с позициями Pos1 и Pos2 местами.

'''Duplicates(Value:integer)''' - изменяет параметр управления дубликатами в списке. Если Value = 0 (значение по умолчанию), то список не реагирует на дубликаты. Если Value = 1, то список при добавлении будет игнорировать дубликаты. Если Value = 2, то список будет выдавать исключение, при добавлении дубликата в список.

'''ParamName(Number:integer[, Delimiter:string])''' - возвращает текст до первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает пустоту.

'''ParamValue(Number:integer[, Delimiter:string])''' - возвращает текст после первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает всю строку.

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

Основные методы:

'''New'''(FuncName, Param1, Param2, ..., Body) — создание новой функции.Функция возвращает результат выполнения последней команды в теле функции. Аргументы:
* `FuncName` — имя функции (строка)
* `Param1, Param2, ...` — имена параметров функции (переменные начинаются с `$`, объекты — без префикса)
* `Body` — тело функции (скрипт, выполняемый при вызове)

'''FuncName'''(Arg1, Arg2, ...) — вызов созданной функции по имени. Если в объявлении была указана тип переменная, то и подставлять в аргумент надо обязательно переменную. Будет передано значение этой переменной (переменные словарине поддерживаются!). Если был объявлен объект, то указатель на объект должен быть получен через метод '''_self'''. C функциями поддерживают работу следующие классы: TExcel, TDirectExcel, TCSVFile, TADO, TSelfADO, TPrinter, TCanvas, TPicture, TTable, TINIFile, TSMS, TXML, TJSON, TZip, TStringList, TBaseUtils, а также объект addressrecord (TFieldObject). Результатом работы функции может быть число или строка.

Пример 1, обработка результатов функции:
<source>
<?>
new('TFunc', 'calc');
calc.new('Sum', '$a', '$b',
$a + $b
);

set($x, 10);
set($y, 20);
showmessage(calc.Sum($x, $y));
</source>

Пример 2, передача объекта в функцию:
<source>
<?>
new('TFunc', 'utils');
utils.new('ProcessDB', 'dbConn', '$value',
showmessage($value);
dbConn.open('SELECT * FROM address limit 3 ');
if(dbConn.recordcount > 0,
showmessage('Найдено записей: ' + dbConn.recordcount);
dbConn.first;
while(dbConn.eof = 0,
showmessage(dbConn.fieldbyname('code'));
dbConn.next
)
,0)
);

new('TSelfADO', 'db');
utils.ProcessDB(db._self,'test!');
</source>

== Применение языка формул ==
'''в различных контекстах системы «MEASOFT» и сопутствующих проектах'''

=== MEASOFT ===

==== Дополнительная информация на чеке ====

В карточке клиента на закладке «Касса» имеется поле для ввода текста, который будет отображаться на кассовых чеках, печатаемых для корреспонденции от данного клиента. В поле может быть введен как просто текст, так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TSelfDB с открытым набором данных со строчкой корреспонденции, заказа и клиента, на которую печатается чек

TBaseSupport

TBaseValue

Все объекты создаются с пустыми именами.

Так же система записывает в переменную $CashRegisterID вычисленный код фискального регистратора, на котором предполагается печать чека.

Результат работы скрипта печатается на создаваемом чеке, если скрипт не возвращает значение “-1” (число или текст) – в этом случае система чек не создает. Подразумевается, что либо скриптом было принято решение об отсутствии необходимости формирования чека, либо скрипт взял эту функцию на себя.

==== Заполнение шаблонов печатных форм ====

==== Дополнительные возможности ====

==== Импорт БД из Excel ====
В окружении интерпретатора создается объект ZakazRecord, он является списком со значениями таблицы zakaz. Именно в этот заказ будут загружены данные. Из этого объекта также доступно : 
*ZakazRecord.userfields - пользовательские поля заказа;
*ZakazRecord.Clients - данные таблицы clients;
*ZakazRecord.Clients.userfields - пользовательские поля заказчика.

==== Прайс лист клиента ====

Формула возвращает сумму в валюте клиента для каждой поездки (туда или обратно) единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Помимо стандартных объектов, система создает объект AddressRecord, в котором, как свойства, доступны все поля текущей записи. Так же она выставляет значение переменной $Forward в 1 (истина), если необходимо произвести расчет для направления "Туда" и 0 (ложь) - если обратно. ВНИМАНИЕ! Как и во всех остальных местах, после формулы нельзя ставить ";", иначе скрипт вернет 0!

Например:

if(int(AddressRecord.Time_Put_Max)>19, 100, 0)

''Прибавляет 100 рублей в случае, если максимальный срок доставки 20 часов или более''

if(pos(AddressRecord.Address, 'Аренда')>0,
set($FormulaReplace, 1);
1500
, 0)

''В случае наличия подстроки "Аренда" в адресе заменяет штатное ценообразование на 1500 рублей''

Объект AddressRecord может предоставить доступ к связанным таблицам :
* addressrecord.boxes
* addressrecord.packages
* addressrecord.clients
* addressrecord.price
* addressrecord.advprice
* addressrecord.userfields
* addressrecord.addressfld
* addressrecord.clients.userfields
* addressrecord.price.userfields
* addressrecord.zakaz
* addressrecord.zakaz.userfields

Чтобы получить доступ к полю VarCode из таблицы userfields необходимо записать AddressRecord.Userfields.VarCode. В присоединённой таблице может быть несколько записей чтобы получить к ним доступ предусмотрены функции _First, _EOF, _Next, _RecordCount, _Set.

Пример:
set($value1, 0); set($value2, 0);
while(AddressRecord.userfields._EOF=0,
if(AddressRecord.userfields.varCode=1,
set($value1, if(AddressRecord.userFields.VarValue='Праздничная упаковка', 150, 0)), ''''''');
if(AddressRecord.userfields.varCode=2,
set($value2, AddressRecord.userFields.VarValue), ''''''');
AddressRecord.userFields._Next;
);
int($value1) + int($value2)

Пример делающий тоже самое что и выше но через поиск Locate:
set($value1, if(addressrecord.userfields.VarValue('VarCode', 1)='Праздничная упаковка', 150, 0));
set($value2, int(addressrecord.userfields.VarValue('VarCode', 2)));
$value1 + $value2

В скрипте доступны переменные:
«$FormulaKoeff» - это коэффициент на который умножится конечная цена (по умолчанию равна 1);
«$PriceCode» - код прайса;
«$CurrentPriceConf» - код услуги;
«$BasePrice» - стоимость всех услуг с уровнем (pricelevel) меньше текущего.

Для вызова функции CalcBasePrice (Расчёт базовой цены) в скрипте объявленны переменные: $Count,$Collection,$Distance,$Wait.

Существует поиск по ключевому полю (поиск регистронезависимый), например чтобы найти в таблице advprice введённое значение для текущей услуги, нужно сделать такую запись addressrecord.advprice.value('priceconf', $CurrentPriceConf) - Первый параметр это ключевое поле, второй искомое значение. Если запись найдётся будет возвращено значение поле value, если нет функция вернёт значение 0.

Пример
if(addressrecord.advprice.active('priceconf', 3)='T', addressrecord.advprice.price, 0)

''Смотрим включена ли услуга и если да, возвращаем рассчитанную стоимость

Чтобы изменить значение записанное в объект addressrecord, нужно воспользоваться методом _set(keyfield, keyvalue, filed, value). Параметр keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Сначала происходит поиск строки по ключу, далее меняется значение указанного столбца.
Пример, отключение услуги база:
addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

Также существует упрощенный метод _set, с двумя параметрами filed, value - он используется в шаблонах загрузки или в системных доп. возможностях где доступен объект addressrecord.

==== Зарплата курьеров ====

Формула возвращает сумму в основной валюте для каждой единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Переменные «$FormulaTablKoeff» и «$FormulaMoneyKoeff» позволяют установить повышающий или понижающий коэффициент на стоимость доставки (по тарифной сетке) и услуги соответственно (процент от суммы, процент от стоимости доставки, ожидание). Переменная «$UsingZoneName» и «$KurierZone» содержат название и код зоны соответственно, есть возможность поменять название зоны для отчета.

=== Планировщик ===

В поле текста задания может быть введен как текст с командами планировщика (см ниже), так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TIniFile, Указывает на настроечный ini-файл планировщика.

Все объекты создаются с пустыми именами.

Для записи в лог планировщика нужно использовать функцию Print

=== Репликатор ===

== Прочее ==
ReplaceAddress(target, address) – Возвращает адрес последней доставки корреспонденции получателю target по адресу address от текущего клиента. При отсутствии такой доставки, возвращает address.

GetPrice –возвращает рассчитанное значение цены, на основе прайс-листа клиента и данных о корреспонденции.

GetKurierByStation(i) – возвращает код курьера, ассоциированного со станцией метро с кодом i.

GetNewNumber – Возвращает не занятый номер единицы корреспонденции в текущем заказе.

==История изменений==

=== Недавние изменения ===
{|
||'''Изменено:'''
|2026.0.0.547 Доработка функций ATTACHPDFTOTEXT и PRINTATTACHPDFPAGE, добавлена возможность указать путь к файлу
|-
||'''Добавлено:'''
|2025.0.0.539 Добавлена поддержка отладчика AttachDebugger
|-
||'''Добавлено:'''
|2025.0.0.534 Добавлена поддержка оператора CASE и класса TFunc
|-
|}

=== Версия 2021.0.0.57 от 18.06.2019 ===
{|
||'''Добавлено:'''
|В объект TExcel добавлен метод ColumnDelete.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция InsertFirmAtt.
|-
||'''Добавлено:'''
||В объект TExcel добавлен метод Align.
|-
||'''Добавлено:'''
|Функция CheckEan
|-
||'''Добавлено:'''
|В объект функцию FillAdvPriceReport добавлены параметры ShowSumPrice,InsertColumns
|-
||'''Добавлено:'''
|В объект TSMS добавлен метод Log.
|-
||'''Добавлено:'''
|Добавлена функция Money.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция ValutaSign.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция GetPolygonByLatLon.
|-
||'''Добавлено:'''
|В объект TTable добавлена функция SetMultiHeader, SetCustomHeader.
|-
||'''Добавлено:'''
|Функция DownloadAttachment
|-
||'''Добавлено:'''
|В функцию SetRowHeight объекта TExcel добавлен параметр cnt.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция AsString.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция SetSize.
|-
||'''Добавлено:'''
|В объект TADO добавлена функция ParseForIn.
|-
||'''Изменено:'''
|В объект TBaseUtils из TBase перенесена функция FillExcelDoc.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция CalcAddressPrice
|-
||'''Изменено:'''
|Все функции класса TBaseSupport перенесены в TBaseUtils. Класс TBaseSupport больше не существует.
|-
||'''Добавлено:'''
|В функции RowInsert и RowDelete объекта TExcel добавлен параметр count.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция SendToMeaSoft
|-
||'''Добавлено:'''
|В объект TBaseUtils функция RecalcSpecialSMA
|-
||'''Добавлено:'''
|Новая функция Reverse
|}

=== Версия 849   22.02.2018 ===

{|
||'''Добавлено:'''
|В функцию TBaseUtils.TownByIndex добавлен параметр PriorityName
|-
||'''Добавлено:'''
|В объекте TBase добавлена функция GetNewPackagePos
|-
||'''Добавлено:'''
|В объекте TSMS доработан метод ExtraResult, добавлен параметр ParamName
|-
||'''Добавлено:'''
|В объект TBase добавлена функция CalcAgentPrice
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateAddressForActDelivery
|-
||'''Изменено:'''
|Функция CalcTownDeliveryDate заменена на CalcDeliveryDate
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateSpecialSMA
|-
||'''Добавлено:'''
|Функция SignatureUrl
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция LoadFromStr.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetPen.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetBrush.
|-
||'''Добавлено:'''
|В объект TPicture добавлена поддержка чтения в формате PNG.
|-
||'''Добавлено:'''
|В функцию TCanvas.DrawPic параметр Mode
|-
||'''Добавлено:'''
|Свойство TPicture.Canvas
|-
||'''Добавлено:'''
|Функция DeleteFile
|}

=== Версия 758   29.03.2017 ===
{|
||'''Добавлено:'''
|Функция GetPolygonByAddress
|-
||'''Добавлено:'''
|Функция ParamsCount
|-
||'''Добавлено:'''
|Объект TZip
|-
||'''Изменено:'''
|Функции CreateEAN и Create128 заменены одной функцией CreateBar, полностью совместимой с Create128, но добавлена поддержка EAN-13 и Interleaved 2-5 (для Почты России). В системе функции оставлены для обратной совместимости, но более не являются документированными и рекомендованными к использованию.
|-
||'''Добавлено:'''
|Параметр text в функцию Cell объекта TExcel
|-
||'''Добавлено:'''
|Функция UrlEncode
|-
||'''Добавлено:'''
|Функция IncDay теперь может принимать параметр count
|-
||'''Добавлено:'''
|Функции FtpGet, FtpPut, TTable.SetCell()
|}

=== Версия 452   26.02.2014 ===

{|
||'''Добавлено:'''
|Функция Time
|-
||'''Добавлено:'''
|Функция FixedIntToStr
|-
||'''Добавлено:'''
|Функция TimePeriod
|-
|'''Добавлено:'''
|В интерпретатор добавлена функция приёма смс - ReceiveSMS
|-
|'''Добавлено:'''
|Функция STR2UTF
|-
|'''Добавлено:'''
|Функция SAVETOFILE
|-
|'''Добавлено:'''
|Функция TExcel.SetSheetName
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "FILESTR"
|-
|'''Добавлено:'''
|Расширены возможности объекта addressrecord в формулах тарифов
|}

=== Версия 308   24.11.2012 ===

{|
|'''Добавлено:'''
|В функции загрузки таблиц из TADO добавлено условие, что поля, названия которых начинаются с "-" не выгружаются. Таким образом можно скрывать служебные поля из результирующего набора.
|-
|'''Добавлено:'''
|Функция TExcel.RowAutoFit
|-
|'''Добавлено:'''
|Функция TExcel.RowInsert
|}

=== Версия 300   01.11.2012 ===

{|
|'''Добавлено:'''
|В объекте TCSVFile добавилась возможность запрашивать значения не только текущей записи через параметр сдвига
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "UPDOWN"
|-
|'''Добавлено:'''
|В интерпретатор добавлен объект TCSVFile
|}

=== Версия 266   14.09.2012 ===

{|
|'''Добавлено:'''
|В интерпретатор добавлена поддержка массивов
|}

=== Версия 265   11.09.2012 ===

{|
|'''Добавлено:'''
|Функция CreateTrans в интерпретатор
|-

Руководство программиста

2026-01-13T17:16:51Z

Sammy: /* История изменений */

== Основные положения ==

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

Как интерпретатор приводит типы:

1. При использовании значения как параметр функции интерпретатор автоматически приводит значение к типу, необходимому функции.

2. При операциях сложения, а также логических операциях, операнды приводятся к строке если хотя бы один из них имеет тип «строка». Например:
3.3+5 -> 8.3
‘3.3’+5 -> ‘3.35’
подобную проблему можно решить принудительно преобразовав тип:
float(‘3.3’)+5 -> 8.3

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

Как работают функции приведения типов:

1. При преобразовании строки к числу: функция «читает» строку до первого символа, не позволяющего создать число с плавающей точкой, при этом разделителем целой и дробной частей может быть как точка так и запятая. Если приведение производится к целочисленному типу, то после этого происходит округление. Например:
float('3.6qwerty735') -> 3.6
int('3.6qwerty735') -> 4

2. При преобразовании к булевому типу ложью считается пустая строка либо число 0, все остальное - истина

3. При преобразовании булевого типа к числу истина преобразуется в 1, ложь – в 0. Такое преобразование позволяет использовать сложение и умножение в качестве логических «ИЛИ» и «И» соответственно:
if((5=5)+(6=7), <a>, [b]) – условие истинно, выполнится код «a».

4. При преобразовании булевого типа к строке сначала происходит преобразование к числу:
(5=5)+'qwerty' -> ‘1qwerty’

== Описание синтаксиса ==

Команды разделяются точкой с запятой. Параметры функций разделяются запятыми. Каждая команда (даже цикл while) является функцией, возвращающей некоторое значение. Результатом выполнения составной команды (последовательности функций, разделенных точкой с запятой), является результат выполнения последней функции. Имена переменных, функций, объектов, а также их свойств и методов не чувствительны к регистру.
Константы: константы бывают целочисленными, дробными и строковыми. Значения целочисленных и дробных констант указываются «как есть» (в этом случае разделитель целой и дробной частей – точка), шестнадцатеричные значения начинаются с символа «$» и, если первая цифра – буква, она упреждается цифрой 0, а строковые – в одинарных кавычках. При этом, если внутри строковой константы встречается символ одинарной кавычки он должен быть задвоен, для указания интерпретатору того, что он не является признаком конца константы.
Операции сравнения: >, <, =, ! - Больше, меньше, равно, не равно соответственно.
Логические операции: + (ИЛИ), * (И).
Арифметические операции: +, -, *, /
Операция конкатенации строк: +

=== Функциональность базового объекта ===

'''SET($a, a)''' – присваивает переменной (1-й параметр) значение второго параметра. При отсутствии переменной – создает ее. Имена переменных должны начинаться с символа «$», а следующий символ не должен быть цифрой. Возвращает новое значение переменной. Функция используется только для задания значений переменных. Не допускается использования для задания значений свойств объектов. Для этого используются соответствующие методы этих объектов.

'''IF(a,b,c)''' или '''IF(a,b)''' – Условный оператор. В первом случае возвращает b, если a истинно (не равно нулю или пустой строке), иначе – c. Во втором случае – возвращает a, если оно истинно, иначе – b.

'''WHILE(a, b)''' – Оператор цикла. Выполняет b пока a истинно:
set($i, 10);
set($sum, 0);
while($i>0, set($sum, $sum+$i); set($i, $i-1));
$sum
Результат – 55

'''FOR($a, b, c, d)''' – Оператор цикла. Выполняет d пока $a последовательно присваиваются значения от b до с включительно:
set($sum, 0);
for($i, 1, 10, set($sum, $sum+$i));
$sum
Результат – 55

'''NEW(ClassName, InstanceName)''' – Создает экземпляр класса ClassName, назначает ему имя InstanceName. Возвращает порядковый номер созданного объекта. Доступ к свойствам и методам объектов осуществляется по имени объекта и имени свойства/метода, разделенным точкой. Именем объекта может быть и пустая строка, тогда доступ к его свойствам и методам будет осуществляться без указания имени, и, в случае совпадения имен свойств и/или методов со стандартными или свойствами/методами других объектов, использоваться будут соответствующие свойства/методы объекта, созданного ранее, а также такой объект невозможно уничтожить до окончания выполнения скрипта. Все объекты созданные во время выполнения скрипта уничтожаются автоматически после окончания его выполнения.

'''FREE(InstanceName)''' – Уничтожает объект с именем InstanceName. Возвращает 0. В случае отсутствия объекта с заданным именем вызывает ошибку.

'''ShowObjects''' – Возвращает список созданных объектов – названия классов и имена.

'''ERROR(message)''' – Вызывает ошибку с текстом message.

'''SHOWMESSAGE(message)''' – Отображает диалоговое окно с текстом message, останавливает выполнение скрипта до закрытия окна пользователем.

'''SimpleAskUser(Message)''' – Выводит диалоговое окно с текстом Message и кнопками «Да» и «Нет». Возвращает 1, если пользователь нажал кнопку «Да», иначе – 0.

'''TRY(a)''' – Выполняет a в «защищенном от ошибки» режиме. Если в процессе выполнения a возникает ошибка, возвращает текст ошибки, иначе – 0 (ложь).

'''REM(….)''' – Код в скобках игнорируется (комментарий).

'''EXEC(FileName, Params, Wait, WindowState)''' – Запускает внешнее приложение FileName с параметрами Params. Если Wait истинно – ожидает завершение процесса. Для WindowState доступны следующие числовые значения:
0 - SW_HIDE
1 - SW_SHOWNORMAL (по-умолчанию)
3 - SW_MAXIMIZE
6 - SW_MINIMIZE
Функция возвращает истину если приложение запущено успешно. Иначе – Ложь.
В случае успеха, при параметре Wait – истина кладет в переменную $LastResult код завершения приложения.

'''CASE''' - Оператор множественного выбора. Позволяет выполнить одно из нескольких действий в зависимости от условий. Синтаксис:
<source>
case(
when(условие1, действие1);
when(условие2, действие2);
...
else(действие_по_умолчанию);
);
</source>

Пример использования:
<source>

set($a, 10);
set($b, 50);

showmessage(
case(
when($a < 5, 50);
when($a < 10, 100);
when($a < 250, 200);
else($a*$b);
)
);
</source>

'''AttachDebugger''' - Команда позволяет подключить открытый [[Отладчик_встроенных_скриптов]] к текущему скрипту. Команда AttachDebugger должна быть '''первой командой''' в скрипте. Добавьте её в самое начало скрипта:

<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Как работает:'''
# При выполнении команды AttachDebugger скрипт останавливается.
# Отладчик автоматически подключается к выполняющемуся скрипту.
# Текст скрипта загружается в редактор отладчика.
# Можно ставить точки останова, просматривать переменные и продолжать отладку.

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Если режим отслеживания не включён, команда `AttachDebugger` игнорируется.
* В режиме отслеживания может работать только один отладчик.
* Команда AttachDebugger должна быть первой командой в скрипте.

=== Строковые функции ===

'''UpCase(s)''' – возвращает строку s в верхнем регистре.

'''LCase(s)''' – возвращает строку s в нижнем регистре.

'''Len(s)''' – возвращает количество символов в строке s.

'''Pos(s, substr [,start])''' – возвращает номер первого символа первого включения подстроки substr в строку s, возвращает 0, если включения подстроки отсутствуют. Параметр start - это позиция старта поиска, не обязательный параметр, по умолчанию равен 1. Поиск не чувствителен к регистру.

'''Param(s, i)''' – возвращает i-й элемент строки s, разделенной запятыми на элементы.

'''ParamsCount(s)''' - возвращает количество элементов строки s, разделенной запятыми на элементы.

'''SetParam(s, p, i)''' – заменяет на значение p i-й элемент строки s, разделенной запятыми на элементы.

'''Left(s, i [,full] )''' – возвращает i первых символов строки s. Параметр i, может быть строкой, тогда он считается разделителем и функция, возвращает строку слева от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Mid(s, i, j)''' - возвращает подстроку из s начиная с i символа и длиной j символов

'''Right(s, i [,full])''' – возвращает i последних символов строки s. Параметр i, может быть строкой, тогда он считается разделителем, функция ищет разделитель с конца строки, и возвращает строку справа от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Reverse(s)''' - возвращает строку s задом-наперед. Полезно например для поиска с конца функций Pos().

'''Char(i)''' – возвращает символ с кодом i.

'''Ord(s)''' – возвращает код первого символа строки s.

'''Replace(s, strFind1, strReplace1, [ strFind2, strReplace2, ... ], [caseInsensetive])''' - возвращает строку s, в которой все включения строк strFind заменены строкой strReplace. Параметры поиска и замены всегда должны быть в паре и их может быть несколько. caseInsensetive - неучитывать регистр, не обязательный параметр, по умолчанию включен.

'''RemSpace(s)''' – возвращает сроку s без начальных и конечных запятых и пробелов, а также начальных точек.

'''SumStr(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''с добавлением валюты'''. Необязательные параметры captions - позволяет изменить название валюты, формат строки может зависеть от текущего языка(посмотреть формат можно в "Справочники"-"Статусы"-"32 Валюты", в разделе "Дополнительная информация"). Language - код языка на котором необходимо вывести сумму прописью. По умолчанию если не обязательные параметры опущены, используются региональные настройки в переменных.

'''NumToStrSimple(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''без валюты'''. Параметры идентичны функции SUMSTR.

'''FullNameToShort(Name)''' – Возвращает фамилию и инициалы по полному ФИО Name.

'''MonthName1(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в именительном падеже.

'''MonthName2(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в родительном падеже.

'''StrForXML(s)''' - Подготавливает строку к парсингу как xml: Если находит в строке подстроку "UTF-8" - перекодирует ее из utf-8 в win-1251, убирает начальный знак вопроса, если такой встречается.

'''FixedIntToStr(i, len[, char])''' - Возвращает целое число i дополненное слева символами char (по-умолчанию - "0") до длины len.

'''Translate(format, [param1, param2, ...])''' - Функция перевода строки format в язык пользователя. Строка format может содержать параметры %s, %d - строка и число соответственно.

'''ExtractFileName(FilePath)''' - возвращает имя файла с расширением из полного пути к файлу FilePath.

====Функции перекодировки====
'''DecodeStr(s, charset)''' - Производит перекодировку строки s в кодировку CP1251. Кодировка строки s должна быть заранее известна и может быть :
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866, UNICODE. Имя кодировки следует передавать в точности без лишних символов.

'''EncodeStr(s, charset)''' - Производит перекодировку строки s в кодировку charset. Кодировка строки s должна быть CP1251, возможны следующие варианты перекодировки:
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Имя кодировки следует передавать в точности без лишних символов. UNICODE не работает с версии 2021, в ней строки по умолчанию в кодировке unicode.

Функции EncodeBase64(s), DecodeBase64(s), UrlEncode(s), UTF8Encode(s), UTF8Decode(s), Str2UTF(s) - устарели, используйте EncodeStr, DecodeStr.

====Транслитерация====

'''Translit(s)''' - транслитерация строки русского текста s латиницей

'''UnTranslit(s)''' - транслитерация строки s с латиницы на русский.

==== Экранирование ====

'''QUOTEDSTR(s)''' – квотирует строку s символом «\» (обратный слеш). Возвращает строку s, помещенную между символами одинарной кавычки, при этом все вхождения в строку s символов: «\», «"» и «'» экранируются квотирующим символом, а символы #0, #10 и #13 заменяются на \0, \n и \r соответственно.

'''SQLFloat(f)''' – Приводит число с плавающей точкой к виду, пригодному для SQL-запроса, т.е. к тексту с разделителем дробной части – точка.

'''FormatTextXML(s)''' - квотирует строку s для использования в XML. Производит замены спец. символов для корректности XML-синтаксиса.

'''FormatTextJSON(s)''' - переводит строку в формат JSON, экранирует служебные символы.

'''FormatTextBlob(s)''' - строка s содержит файл, функция перекодирует переданную строку в байты, используется для заполнения полей формата blob.

====Хеширование ====

'''HMACHash256(key, text)''' - создаёт хэш по алгоритму SHA256 для проверки целостности сообщения, key - секретный ключ, text - хэшируемое сообщение

'''MD5Hash(text)''' - создаёт хеш по алгоритму MD5

'''SignatureUrl(url)''' - Подписывает переданный URL. Функция возвратит переданный URL с добавленным в конце параметром, в котором будет записана подпись.

=== Функции работы с датой и временем ===

'''CurrTime''' – возвращает текущее время

'''CurrDate''' – возвращает текущую дату

'''CurrMillisecond''' - Возвращает количество миллисекунд прошедших с начала текущего года. Используется для точного расчета временных интервалов.

'''Today''' - возвращает текущую дату в числовом формате.

'''Day(dt)''' – возвращает день месяца даты dt.

'''Month(dt)''' – возвращает месяц года даты dt.

'''Year(dt)''' – возвращает год даты dt.

'''FirstDayOfMonth(dt)''' – Возвращает первый день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( FirstDayOfMonth( CurrDate() ) );
'''Полужирное начертание'''
'''LastDayOfMonth(dt)''' – Возвращает последний день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( LastDayOfMonth( CurrDate() ) );

'''DaysInMonth(month, year)''' – Возвращает количество дней в указанном месяце.

'''IncDay(dt, [count=1])''' – Возвращает дату, увеличенную на count дней.

'''SQLDate(dt)''' – Пытается конвертировать dt в дату, вернуть в формате «'YYYY-MM-DD'» (с апострофами), если не удается – возвращает «NULL».

'''SQLDateToDate(dt)''' – Переводит дату из SQL-формата в обычный.

'''DAYSBETWEEN(dt1, dt2)''' – Возвращает количество дней между датами dt1 и dt2. В случае ошибки приведения dt1 или dt2 к дате возвращает -1000.

'''TimeBetween(t1, t2)''' - Возвращает количество минут между временем t1 и t2. Если t1 > t2 то будет показано количество минут между t2 и t1. Параметр t может быть как в формате "HH:MM", так и в числовом. Если один из параметров не удалось привести к числовому типу возвращает -1000.

'''WorkDaysBetween(dt1, dt2, [DecreaseFirstDay=0], [DefaultHolidayVarNum=1])''' - Возвращает количество рабочих дней между датами dt1 и dt2. Параметр DecreaseFirstDay уменьшает dt1 на указанное количество дней (по умолчанию 0). В случае ошибки приведения dt1 или dt2 к дате возвращает -1000. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней(по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''TimePeriod(time1, time2)''' - Оформляет временной период. Возвращаемое значение зависит от наличия значения в параметрах. Возможные варианты: "time1 - time2" , "С time1" , "ДО time2".

'''StrDateToFloat(s, [time=false])''' - Переводит строку с датой s в числовой тип. Если параметр time включен, то в строке s должно быть указано время. Дата должна быть в формате "DD.MM.YYYY", а время "HH:NN". Если строку перевести не удалось возвращает 0

'''IsAWorkDay(dt)''' - Когда день dt является рабочим, возвращает true. Если произошла ошибка приведения даты возвращает -1000.

'''IncWorkDay(dt, [count=1],[DefaultHolidayVarNum=1])''' - Прибавляет count рабочих дней к дате dt. Возвращает дату в числовом формате, если произошла ошибка приведения даты возвращает -1000. По умолчанию параметр count равен 1 и не является обязательным. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней (по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''Sleep'''(n) - Задержка выполнения на n миллисекунд.

=== Функции приведения типов ===

'''INT(v)''' – возвращает значение типа “целое”, приводя вариантное значение v к числовому типу, а затем округляя его. В том числе используется как функция округления.

'''FLOAT(v)''' – возвращает значение типа “число”, приводя вариантное значение v к числовому типу, переводя в число цепочку символов до первого нецифрового символа (либо точки или запятой).

'''STR(v)''' – возвращает значение типа “строка”, приводя вариантное значение v к строковому типу.

'''Date(v)''' – возвращает дату, либо пустую строку, если не удается конвертировать v в дату

'''Time(v)''' – возвращает время, либо пустую строку, если не удается конвертировать v во время. Понимает числовое представление времени.

=== Математические функции ===

'''ROUNDUP(f)''' – округляет число f до ближайшего большего по модулю целого числа.

'''ROUNDDN(f)''' – округляет число f до ближайшего меньшего по модулю целого числа.

'''Money(f, CouldBeEmpty, ZeroFill, MakeSpace)''' - Округляет число f, до двух знаков после запятой. CouldBeEmpty - заменить число меньше 0,0001 на пустую строку. ZeroFill - Следить чтобы после запятой было два знака, если будет один, то добавить ноль. MakeSpace - Разделить разряды пробелом.
''Подсказка: для простого округления используется функция int()''

'''Abs(f)''' - возвращает модуль числа f.

'''Mod(x, y)''' - возвращает остаток от деления целочисленного числа x на целочисленное число y.

=== Константы ===

'''Null''' – Возвращает пустое значение.

'''Да''', '''True''', '''Нет''', '''False''' – константы, соответствующие булевым значениям.

=== Прочие функции ===

SetPhoneParams(CountryCode, TownCode) – Устанавливает глобальные настройки кода телефонных кодов страны и города соответственно. По-умолчанию код страны – 7, код города – 495.

PhonesCount(s) – Возвращает количество корректных телефонных номеров, найденных в строке s.

GetPhone(s[, n]) – Возвращает n-й корректный телефонный номер, найденный в строке s. Нумерация начинается с 1.

GetEmail(s) – Возвращает все корректные адреса email, найденный в строке s, разделенные запятыми (т.е. готовыми к передаче в функцию SendEmail).

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

GenEan(ID, Code) – Формирует штрих-код EAN 13 Состоящий из идентификатора типа сущности ID и кода сущности Code, Выравнивает до 13-ти символов, первый – «2», последний – контрольная сума.

CheckEan(s) - Проверяет строку s, что она является кодом EAN13.

SaveToFile(FileName,s, encoding [, append])- Создает текстовый файл по пути, указанному в FileName (если по указанному пути существует файл с указанным именем, он удаляется и создается новый) и производит запись строки s в созданный текстовый файл. encoding - название кодировки, по умолчанию сохраняет в кодировке ANSI. Доступные названия кодировок: KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Если append = true, то производится дописывание данных в файл, а не перезаписывание (не обязательный, по умолчанию выключен).

StrFromFile(FileName) - Читает файл FileName, возвращает в виде строки. При ошибке чтения вызывает ошибку.

DownloadAttachment(code, [savefilepath, tablename='attachment', fieldBlob='file', fieldLDtime='ldtime', fieldUID='uid']) - Функция выкачивает аттачмент из базы, по внутреннему коду - Code, всегда возвращает содержимое файла в виде строки, а также может сохранить файл по указанному пути в параметре savefilepath. По умолчанию, функция настроена на таблицу attachment. Code - внутренний код вложения, tablename - название таблицы, fieldBlob - название поля с содержимым файла, fieldLDtime - название поля с временем последнего изменения строки (для работы кэша). Функция использует кэш и умеет выкачивать файлы зауженные на внешние серверы (http, ftp,sftp, measoft). Для выкачивания с сервера measoft обязательно необходимо указывать параметр fieldUID.

DeleteFile(FileName) - Удаляет файл FileName с диска, возвращает истину, если операция прошла успешно и ложь - в противном случае.

HTTPPOST(host, PostParams, Proxy, ContentType, HTTPUser, HTTPPass, Method, CustomHeader, Reconnects) - Отправляет HTTP запрос по адресу host с данными PostParams. Proxy - объект Proxy, задающий прокси-сервер (по-умолчанию - пусто - не использовать прокси). ContentType - Заголовок ContentType. По-умолчанию - "application/x-www-form-urlencoded; Charset=UTF-8". HTTPUser и HTTPPass - данные для http-авторизации на сервере. Method - метод отправки запроса, по-умолчанию - "POST". CustomHeader - Дополнительные заголовки HTTP запроса, передается в виде списка параметров через запятую и всегда образуют пару: 1 параметр - название заголовка, 2 параметр - значение. Если значение содержит запятую то его нужно экранировать в двойные кавычки. Reconnects - Количество попыток подключения (по-умолчанию - 2), если больше 100 - это таймаут единственной попытки подключения в миллисекундах.
Функция возвращает ответ сервера. 
''Обратите внимание:'' Для имитации отправки данных html-формы методом POST может понадобиться перед передаваемыми параметрами добавить "Data=".

FTPPUT(host, User, Pass, FileName[, Active]) - Отправляет файл на FTP/SFTP-сервер. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

FTPGET(host, User, Pass, SourceFileName, DestFileName[, Active]) - Загружает файл SourceFileName с FTP/SFTP-сервера, сохраняет его в файл DestFileName. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

GetTempDir - Возвращает путь к временной папке.

ApplicationDir - Возвращает путь к файлу программы.

Interpretate(script) - Интерпретирует скрипт указанный в script. Выполнение происходит в текущем инстансе.

LastHttpError - Выводит последний запрос выполненный с ошибкой в функции HttpPost. Содержит подробную информацию по запросу и ответу.

LastHttpResponse - Выводит последний запрос и ответ от сервера после выполнения Http-запроса в функции HttpPost.

== Объект TExcel ==

Предназначен для доступа к данным документов MS Excel. Требует установленного приложения MS Excel. Для работы без установленного MS Excel предусмотрен объект TDirectExcel.

'''''Ввод данных'''''

LoadFromDB(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Если Headered истинно (по-умолчанию), таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Если TranslateHeader истинно, то заголовки таблицы будут автоматически переведены.

MyDB.Open('select * from kurier');
xl.LoadFromDB(MyDB.Self);
xl.DoNotDestroy(true);
xl.SetVisible(true);

Post2Sheet(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) - Почти полный аналог LoadFromDB. В отличии от LoadFromDB если есть открытый файл, выгрузка данных будет выполнена прямо в него.

OpenFile(aFileName) – Выполняет функции SetFileName и Open.

FileName – Возвращает имя текущего файла.

SetFileName(aFileName) – Задает значение свойства FileName.

Open - Открывает файл с именем, заданным свойством FileName. Если имя файла не задано - создает чистую книгу.

Close – Закрывает текущий файл.

'''''Ячейки'''''

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

Cell(x, y, text) – Возвращает значение ячейки, заданной координатами x, y. Необязательный булевый параметр text, в случае истинности, указывает на необходимость возврата данных с учетом формата ячейки, т.е. то, что пользователь видит на экране. Обратите внимание, что если в ячейке число, и ширина столбца не достаточна для отображения, Excel выводит "#####", что и будет возвращено программе, если text=ИСТИНА. Поэтому перед таким использованием рекомендуется выполнить функцию AutoFit.

SetCell(x, y, v[, x2, y2]) – Устанавливает значение ячейки, заданной координатами x и y, в значение v. Если заданы параметры x2, y2 - объединяет (merge) диапазон ячеек заданных координатами, устанавливает значение объединенной ячейки.

'''''Строки'''''

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

RowAutoFit([y1, y2]) - Устанавливает автоматическую высоту строк. Аргументы y1 и y2 необязательны и если не указаны, то процедура будет выполнена для всей страницы, в ином случае только для строк от y1 до y2.

SetRowHeight(r, h[, cnt]) – Устанавливает высоту cnt строк (по-умолчанию 1) начиная со строки r в h пикселей.

GetRowHeight(r) – Возвращает высоту строки r в пикселях.

RowInsert(i[, count]) - Вставляет count (по-умолчанию - 1) строк НАД строкой с номером i.

RowDelete(i[, count]) - Удаляет count (по-умолчанию - 1) строк начиная с номера i.

'''''Столбцы'''''

ColCount - Возвращает количество столбцов в листе.

AutoFit – Устанавливает автоматическую ширину столбцов.

ColumnDelete(i[, count]) - Удаляет count (по-умолчанию - 1) столбцов начиная с номера i.

SetColWidth (c, w) – Устанавливает ширину столбца c в w пикселей.

GetColWidth (c) – Возвращает ширину столбца c в пикселях.

'''''Листы'''''

SetSheet(No) – Устанавливает номер текущего листа. Если лист с таким номером не существует - он будет создан (и все листы до него). Нумерация начинается с 1.

SetSheetName(Name) - Устанавливает название текущего листа.

SheetsCount – Возвращает количество листов в книге.

CopySheetAfter([SheetFrom[, SheetAfter]]) - Копирует лист SheetFrom (по-умолчанию - текущий), создавая новый лист после листа SheetAfter (по-умолчанию - совпадает с копируемым).

SheetDelete(i) - Удаляет лист с номером i.

'''''Форматирование'''''

Align(x1, y1, x2, y2 [,HAlign, VAlign]) - Устанавливает выравнивание данных в указанном диапазоне. HAlign - горизонтальное выравнивание (0 – прижато влево , 1 – по центру , 2 – прижато вправо), VAlign - Вертикальное выравнивание (0 – прижато к верху , 1 – по центру , 2 – прижато к низу).

WrapText(x1, y1, x2, y2, value) – Устанавливает перенос текста прямоугольника в значение value. Если координаты опущены, или 0 – устанавливает границы всей используемой области. Для Value значение по-умолчанию - true.

NumberFormat(x1, y1, x2, y2, Format) - Устанавливает формат вывода чисел в указанном диапазоне ячеек. Например, если Format='0.00' - числа будут выводиться c обязательными 2 знаками после десятичного разделителя.

SetBorders(x1, y1, x2, y2) – Устанавливает границы прямоугольника. Если координаты опущены, или 0 – устанавливает границы всей используемой области.

SetFont(Font[, x1, y1[, x2, y2]]) - Устанавливает шрифт Font для ячеек диапазона. Можно указать координаты только одной ячейки, можно - вообще не указать, тогда будет использован последний выделенный диапазон. Шрифт задается как обычно: 'Arial, 16, T, T, T', порядок параметров: Имя шрифта, размер, жирное начертание, курсивное начертание, одиночное подчеркивание. Если параметры не заданы, то у текущего шрифта они меняться не будут. Примеры: SetFont('Arial, 10, T, F, F', 1,1) - в ячейке A1 будет установлен шрифт Arial жирным начертанием (не курсив и без подчеркивания). SetFont(', , , T, F', 2,1) - в ячейке B1 будет поменяется только начертание курсив и будет отменено подчеркивание (если оно было).

SaveValuesOnly - убирает формулы на текущей странице и оставляет лишь их результативные статичные значения.

'''''Цвета'''''

SetRowFontColor(Row,Color) - Устанавливает цвет шрифта в строке Row. Color - целое значение (RGB)

SetRowColor(Row,Color) - Устанавливает цвет фона в строке Row. Color - целое значение (RGB)

SetColumnFontColor(Col,Color) - Устанавливает цвет шрифта в столбце Col. Color - целое значение (RGB)

SetColumnColor(Col,Color) - Устанавливает цвет фона в столбце Col. Color - целое значение (RGB)

SetCellFontColor(Row,Col,Color) - Устанавливает цвет шрифта в ячейке с координатами [Row,Col]. Color - целое значение, равное номеру цвета в палитре (ColorIndex,не RGB)

SetCellColor(Row,Col,Color) - Устанавливает цвет фона в ячейке с координатами [Row,Col]. Color - целое значение (RGB)

GetRowFontColor(Row)- Возвращает RGB значение цвета шрифта строки Row

GetRowColor(Row)- Возвращает RGB значение цвета фона строки Row

GetColumnFontColor(Col)- Возвращает RGB значение цвета шрифта столбца Col

GetColumnColor(Col)- Возвращает RGB значение цвета фона столбца Col

GetCellFontColor(Row,Col) - Возвращает номер цвета шрифта в палитре (ColorIndex) в ячейке с координатами [Row,Col]

GetCellColor(Row,Col) - Возвращает RGB значение цвета фона в ячейке с координатами [Row,Col]

'''''Копи-паст'''''

Copy(x1, y1, x2, y2) - Копирует в буфер экселя

Cut(x1, y1, x2, y2) - Вырезает в буфер экселя

Paste(x1, y1) - Вставляет из буфера экселя. Команды copy-paste неразрывны, если что нибудь сделать в промежутке между ними, например вставить значение в ячейку, то копирование сброситься. (Последовательность использования: copy - paste, cut - paste)

PasteStyle(x1, x2, y1, y2) - Вставляет только оформление из буфера экселя (Последовательность использования: Copy - PasteStyle)

'''''Изображения'''''

InsertPicture(TPicture, [x=1, y=1, DispX=0, DispY=0, width=0, height=0]) - Функция вставляет рисунок на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки, width, height (не работает для DirectExcel) - ширина и высота области рисунка в пойнтах-единицах Excel

InsertFirmLogo(FirmCode, [x=1, y=1, DispX=0, DispY=0]) - Функция вставляет логотип фирмы с кодом FirmCode на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки.

'''''Вывод'''''

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки. Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SheetFitPageWidth - устанавливает режим масштабирования печати, чтобы печатная форма помещалась в ширину на один лист.

SetOrientation(value) - Устанавливает ориентацию страницы. True (по-умолчанию) - альбомная (ландшафтная), Ложь - портретная.

PrintOut([copies]) - Печатает текущий лист на принтере по умолчанию. Параметр copies - количество копий, по умолчанию равен 1.

Save(filename) - Сохраняет в файл filename. Если файл существует, в основной системе он будет перезаписан, в других проектах - вызовет ошибку "Файл уже существует".

SetVisible(b) – Устанавливает видимость приложения Excel для пользователя. По-умолчанию – false (не видимо).

DoNotDestroy(b) – При уничтожении объекта TExcel (а он уничтожается, как и все остальные объекты автоматически при завершении выполнения скрипта), приложение Excel уничтожается вместе с ним. DoNotDestroy(true) отключает уничтожение приложения.

'''''Пример использования'''''

new('TExcel', 'myxl');
myxl.OpenFile('c:\asdf.xlsx');
set($sum, 0);
while (myxl.EOF=0,
set($sum, $sum+int(myxl.c));
myxl.next );
$sum

''Возвращает сумму всех числовых данных столбца C файла 'c:\asdf.xlsx'''

== Объект TDirectExcel ==
Объект позволяет работать с файлами Excel напрямую, без установленного пакета MsOffice. Применяется в сервисах и при отсутствии экселя. Он максимально совместим с объектом TExcel, однако некоторые методы могут быть не реализованы.

== Объект TCSVFile ==
Предназначен для доступа к данным документов CSV. Разделителем столбцов является символ точка с запятой ;

Функции:

FileName – Возвращает имя текущего файла.

OpenFile(FileName) – Открывает файл FileName.

LoadFromDB(DB[, Headered=false]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO.

LoadFromText(s) - Загружает таблицу из строки s.

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки.

SaveToFile(Filename) - Сохраняет в файл с именем filename.

== Объект TADO ==

Предназначен для доступа к базам данных.

Функции:
{| class="wikitable"
!Функция
!Описание
|-
|Connect(ConnectionString)
|Подключает к источнику данных. ConnectionString – Строка подключения ADO.
|-
|ConnectMySQL(DBServer, DBPort, DBUser, DBPass, DBName)
|Подключает к базе данных MySQL.
|-
|Open(Query)
|Открывает набор данных выполнив запрос Query.
|-
|FieldByNo(i)
|Возвращает значение поля с номером i. Нумерация полей – с нуля.
|-
|FieldName(i)
|Возвращает имя поля с номером i.
|-
|FieldCount
|Возвращает количество полей.
|-
|RecordCount
|Возвращает количество записей.
|-
|RecNo
|Возвращает номер текущей записи. ''ВНИМАНИЕ! В зависимости от способа подключения к БД нумерация может начинаться как с 0 так и с 1!''
|-
|EOF
|Возвращает признак достижения конца набора данных. Становится истиной когда выполняется команда Next на последней записи.
|-
|Next
|Переход на следующую запись набора.
|-
|First
|Переход на первую запись набора.
|-
|Last
|Переход на последнюю запись набора.
|-
|FieldByName(FieldName)
|Возвращает значение поля по имени. Также возможно указание имени поля как свойства объекта.
|-
|Field(Table, ID, FieldName)
|Возвращает значение поля FieldName записи с кодом ID таблицы Table. Набор данных, если он открыт, при этом не закрывается. Первичный ключ таблицы должен называться «code». Гарантированно работает только с MYSQL!!!
|-
|GetSQLValue(Query)
|Выполняет SQL-запрос. Текст запроса должен начинаться с первого символа строки (перед запросом не должно быть пробелов, переносов строк, комментариев и т.д.). Если запрос Insert – возвращает ID вставленной записи. Если запрос – Update, Delete, Replace, Set, Start, Commit, Rollback – возвращает количество измененных записей (RowsAffected), иначе – Select – значение первого поля первой строки результата как текст.
|-
|FillText(s)
|Возвращает строку s с замененными названиями полей между знаками процента на соответствующие значения текущей записи. Так же в строке возможно использование интерпретируемого кода, заключенного между тегами "<?>" и ">". При интерпретации система сначала производит замену полей с процентами на значения, потом интерпретирует код. ''Внимание! Функция не создает отельный контекст интерпретатора, а использует существующий, в нем доступны все объекты и переменные, вызывающего скрипта.'' Дополнительно автоматически создается объект TSelfADO, подключенный к той же БД, что и контекст, вызвавший функцию, с пустым именем, а так же с именем "dataset".
|-
|Query(Query)
|Синоним GetSQLValue.
|-
|Close
|Закрывает набор данных.
|-
|Self
|Возвращает указатель на подключение к БД для использования в других объектах.
|-
|ParseForIn([FieldName='code'])
|Возвращает через запятую значения всех строк в указанном столбце. По умолчанию, используется столбец с именем code.
|-
|GetSQL
|Для отладки. Возвращает последний SQL запрос переданный в методы Open, Query, GetSQLValue
|-
|ExportExcel
|Для отладки. Выгружает в эксель содержимое датасета. Можно использовать в незнакомом окружении для понимания передаваемых полей в : шаблонах, печатных формах и т.д. Аналог команды %echo% в шаблонах, на случай если она не сработает.
|-
|OnGetText
|Функция подменяет текстовый вывод значения поля при выгрузке в эксель. Первый параметр это имя поля, которое надо подменить. Второй параметр это то что необходимо вывести. Работает только с текстовыми полями.
'''''Пример использования'''''
DB.OnGetText('Зона', IF((DB.FieldByName('-Lat') ! 0) * (DB.FieldByName('-Lon') ! 0),
GetPolygonByLatLon(DB.FieldByName('-Lat'), DB.FieldByName('-Lon'), 'TYPE = 1 AND IFNULL(zone, 0) > 0 AND PRICE = ' + DB.FieldByName('-price'), 'zone')
,
''
));
|}

Пример использования – см. TSelfADO

== Объект TSelfADO ==

Наследник объекта TADO. Служит для подключения к «родной» для программы, в которой выполняется скрипт, базе данных. Обладает всеми свойствами и методами объекта TADO, кроме Connect. Иногда автоматически создается системой для обеспечения простого доступа к базе данных, а также иногда создается системой с уже открытым набором данных для передачи обрабатываемого системой набора данных в скрипт. В этом случае для скрипта недоступны функции Open и Close.

Пример использования:

rem('Копируем данные из "родной" базы данных в базу MSSQL.');
new('TSelfADO', 'MyDB');
new('TADO', 'MSSQL');
MSSQL.Connect('Provider=SQLOLEDB.1;Password=myPassword;Persist Security Info=True;User ID=myUsername;Initial Catalog=myDataBase;Data Source=myServerAddress');
MyDB.Open('select code, name, passport from kurier where code>'+Int(MSSQL.Query('select max(code) from kurier'))+' order by code');
While(MyDB.EOF=0,
MSSQL.Query('insert kurier (code, name, passport) VALUES ('+MyDB.Code+', '+QuotedStr(MyDB.Name)+', '+QuotedStr(MyDB.Passport)+')');
MyDB.Next;
);

== Объект TPrinter ==

Предназначен для доступа к принтерам.

Функции:

BeginDoc – Начинает новый документ.

EndDoc – Закрывает документ

PageHeight – Возвращает высоту страницы в пикселях

PageWidth – Возвращает ширину страницы в пикселях

PageNumber – Возвращает номер текущей страницы документа

Orientation – Возвращает текущую ориентацию страницы (0 – портретная, 1 – ландшафтная)

Printing – Возвращает истину если документ открыт

SetOrientation(Orientation) – Устанавливает ориентацию страницы. При необходимости начинает новый документ, новую страницу.

ShowDialog – Показывает пользовательский диалог печати. Возвращает истину, если пользователь нажал "OK".

NewPage – Начинает новую страницу

Canvas – Предоставляет доступ к объекту TCanvas, связанному с принтером.

PrinterNames – Возвращает список принтеров, установленных в системе, разделенный переносами строк

PrintersCount – Возвращает количество установленных в системе принтеров

SetPrinter(Printer) – Устанавливает текущий принтер. Если передана строка – ищет принтер по названию, иначе – по номеру. Нумерация начинается с 0.

PrintTable(Y, Table) – Выводит на печать таблицу Table типа TTable, начиная с координаты Y. При необходимости таблица печатается на нескольких страницах. Возвращает координату Y конца таблицы.

GetDefaultPrinter - Возвращает имя текущего активного принтера.

SetDefaultPrinter(Printer) – Запоминает предыдущий активный принтер и устанавливает новый текущий принтер. Printer - имя принтера. При необходимости нескольких последовательных вызовов SetDefaultPrinter рекомендуется между вызовами использовать RestoreDefaultPrinter.

RestoreDefaultPrinter - Устанавливает активным принтер, который был текущим перед последним вызовом SetDefaultPrinter.

== Объект TCanvas ==

Предоставляет доступ к холсту объекта для прорисовки изображения.

Функции:

DPIX – Возвращает разрешение холста по горизонтали в точках на дюйм

DPIY – Возвращает разрешение холста по вертикали в точках на дюйм

TextOut(x, y, s[, x1, y1, x2, y2]) – Выводит строку s начиная с точки с координатами x и y. Если указаны параметры x1, y1, x2, y2 – то выводимый текст ограничивается заданным прямоугольником.

TextOutEx(x1, y1, x2, y2, Alignment, Font, s, Indent) – Выводит строку s в прямоугольнике с координатами x1, y1, x2, y2. По горизонтали строка выравнивается в соответствии с Alignment (0 – прижато влево, 1 – вправо, 2 – по центру), по вертикали выравнивается по центру. Используя шрифт Font (см описание ниже). Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату X фактического окончания текста (правой стороны – если строка прижата влево, и левой – в остальных случаях)

MLTextOut(x1, y1, x2, y2, Alignment, VAlignment, Font, s, Heigth, Indent) – Выводит многострочный текст s в прямоугольнике с координатами x1, y1, x2, y2 с переносом по словам. По горизонтали строки выравниваются в соответствии с Alignment, по вертикали – в соответствии с VAlignment (0 – прижато вверх, 1 – по центру, 2 – прижато вниз). Используя шрифт Font (см описание ниже). Heigth – высота строки. Если опущено или равно нулю – высота определяется автоматически в соответствии с выбранным шрифтом. Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату Y фактического окончания текста (нижней границы последней строки текста. ''ВНИМАНИЕ! Функция использует координаты прямоугольника для позиционирования текста, однако она не ограничивает его верхней и нижней границами этого прямоугольника!''

DrawPic(x1, y1, x2, y2, Pic, Style, Alignment, Mode) – Прорисовывает изображение Pic (ссылка на изображение TPicture.Self) в прямоугольник заданный координатами x1-y2. Style – стиль масштабирования. 0 – растянуть изображение до границ прямоугольника не сохраняя пропорции, 1 – вписать изображение в прямоугольник сохраняя пропорции – вероятно, останутся поля по вертикали или горизонтали, 2 – вписать сохраняя пропорции, обрезав при необходимости изображение по вертикали или горизонтали. Alignment – выравнивание по горизонтали. Работает только в случае если style=1 и при растягивании изображения получились вертикальные поля. 0 – разместить по центру, 1 – прижать влево, 2 – прижать вправо. Функция возвращает координату X правой стороны изображения кроме случая, когда Style=1 и Alignment=2 – в этом случае возвращается координата левой стороны изображения. Mode - способ наложения изображения. 0 (по-умолчанию) - копирование как есть. 1 - Наложение операцией AND (применяется для получения эффекта прозрачности изображения), 2 - наложение операцией XOR (Применяется для возможности повторной операцией убрать изображение), 3 - Наложение операцией OR.

FillRect(x1, y1, x2, y2) – Рисует прямоугольник '''без границ''' и закрашивает цветом BrashColor

Rect(x1, y1, x2, y2) – Рисует прямоугольник '''c границами''', задаваемыми текущим пером, и закрашивает цветом BrashColor

SetFont(Font) – Устанавливает шрифт по-умолчанию.

SetPen(Width, Color) - Устанавливает параметры "ручки" - толщину и цвет. Если любой параметр опустить, соответствующее значение не будет изменено.

SetBrush(Color, Style) - Устанавливает параметры заливки - цвет и стиль. Если любой параметр опустить, соответствующее значение не будет изменено. Стили заливки: 0 - сплошная, 1 - отсутствует (прозрачная), 2-7 - различные виды штриховки (горизонтальные, вертикальные, в клеточку и т.д.).

TextHeight(s) – Возвращает высоту текста s в пикселях без учета многострочности, с учетом текущего шрифта.

TextWidth(s) – Возвращает ширину текста s в пикселях без учета многострочности, с учетом текущего шрифта.

Использование шрифта (Font): У объекта TCanvas есть «глобальные» установки шрифта. Однако для некоторых функций возможно указание шрифта, отличающегося от глобального. Параметры шрифта – это текстовая строка, состоящая из 6-ти параметров, разделенных запятыми: Название, размер, жирный, курсив, подчеркнутый, цвет. Например:

'Times New Roman, 8, Y, N, N, 255'

Любой параметр можно опустить, и тогда вместо него будет использовано значение по-умолчанию: шрифт: arial, размер – 10, не жирный, не курсив, не подчеркнутый, цвет – черный. Например: ', 7' – указывает, что по-умолчанию нужно взять все параметры кроме размера шрифта. Также можно вместо всей строки указать тире ('-') или пустую строку, и шрифт будет использоваться «глобальный».

Объект можно создать отдельно, не создавая объект TPrinter. В таком случае объект создастся как ссылка на текущий холст принтера (принтер должен быть запущен и начат новый документ). Такой подход используется в доп. возможности PrintCustomSticker

== Объект TPicture ==

Предоставляет функции для работы с графическими изображениями форматов BMP, GIF, JPEG и PNG, а также для формирования штрих-кодов. Обратите внимание, прозрачность изображений не поддерживается, однако в методе TCanvas.DrawPic есть параметр Mode, призванный создавать эффект прозрачности.

Функции:

LoadFromFile(FileName) – Загружает изображение из файла FileName. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromDB(DB, Query) – Загружает изображение из базы данных. DB – ссылка на подключение к базе данных TADO.Self, Query – текст запроса. Запрос должен вернуть в первом поле первой строки BLOB-поле с изображением, все остальные данные возвращаемые запросом игнорируются. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromStr($s) – Загружает изображение из строки $s. Возвращает истину, если операция прошла успешно, иначе – ложь.

CreateBar(Width, Height, BarCode, Textless, Type) – Формирует штрих-код шириной Width и высотой Height с типом кодирования Type. BarCode – текст штрих-кода. Булево значение Textless указывает, что в штрих-коде не должно быть человеко-читаемых символов если истинно. Type указывает тип кодирования: 0 (по-умолчанию) CODE128, 1 - EAN-13, 2 - Interleaved 2-5, 3-DataMatrix, 4-QRCode.
Штрихкод должен быть: Для EAN-13 цифровым 12 или 13 символов (13-й, контрольная сумма рассчитывается автоматически), для CODE128 - должен иметь состоять из допустимого для этого кодирования набора символов. Для Interleaved - должен состоять из четного числа цифр, контрольная сумма автоматически не рассчитывается. Если для Interleaved кода указано значение из 14-ти знаков, подпись цифр выводится в формате Почты России.
Внимание! Для кодов EAN-13 и Interleaved ширина штрих-кода Width не является точным значением получаемого на выходе изображения. Ширина изображения рассчитывается как максимальное кратное минимально возможной ширине, но не меньше минимально возможной. Конечную ширину можно получить в соответствующем свойстве объекта. Для кода CODE128 штрих-код на выходе может оказаться пустым, если указанной ширины штрих-кода не достаточно для его формирования.
Для кода DataMatrix можно установить режим для печати скрытых символов с кодами 29(GS) и 232(FCN1), которые требуются для формирования Честного Знака. Для этого необходимо в начале строки указать символ "[" и все разделители 01, 21, 91, 92 так же экранировать этими скобками. Должно получиться [01]02900002317701[21]k3LInNbH_oG0Q[91]EE06[92]YXiyKfiHjE4YE8b+YVMC1O5r8VtpplA3AwcCqrcG9Dk= . При формировании кода, включится режим формирования штрих-кода DataMatrix GS1, в начале будет добавлен символ с кодом 232 (FCN1), а потом будут добавлены разделители с кодом 29 (GS)
Функция возвращает 1 в случае успеха, или текст ошибки, если такая произошла.

SetSize(Width, Height) - Устанавливает размер изображения.

AsString([ImageFormat]) - Возвращает изображение в виде строки с двоичными данными. ImageFormat принимает значения 1 - Bitmap (по-умолчанию), 2 - jpeg, 3 - png, 4 - gif.

Width – Возвращает ширину изображения.

Height – Возвращает высоту изображения.

Rotate(Angle) – Поворачивает изображение по часовой стрелке на угол Angle. Угол указывается в градусах и может принимать любые значения.

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

Canvas - ссылка на объект TCanvas холста изображения.

== Объект TTable ==

Предоставляет функции для работы с таблицами. Удобен для печати таблицы на принтере. Алгоритм таков: Загружаем датасет в таблицу, настраиваем ее (шрифты, штрих-коды и т.д.), потом выводим на принтер функцией TPrinter.PrintTable.

Функции:

LoadFromDB(DB) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Заголовок – это первая строка таблицы.

Cell(С, R) – Возвращает значение ячейки таблицы с координатами (C, R). Нумерация строк и столбцов начинается с 1.

SetCell(С, R, Value) – Устанавливает значение ячейки таблицы с координатами (C, R) в Value. Нумерация строк и столбцов начинается с 1.

RowCount – Возвращает количество строк в таблице.

ColCount – Возвращает количество столбцов в таблице.

SetTitleFont(Font) – Задает шрифт заголовка таблицы (первой строки).

SetFont(Font) – Задает шрифт всей таблицы кроме заголовка.

SetColFont(C, Font) - Устанавливает шрифт столбца C.

SetIndent(Indent) – Задает отступ от границы ячейки до текста в процентах от ширины страницы. По-умолчанию значение 0.3

SetWidth(С, Width) – Задает значение ширины столбца C в процентах от ширины страницы.

SetMinRowHeght (Heght) – Задает значение минимальной высоты строки в пикселях.

SetBarCode(Col, Type) - Указывает, что данные из столбца Col должны печататься в виде штрих-кода. Тип штрих-кода - Type. Значение '''"1" - EAN13'''. Для кода EAN13 первая строка данных в ячейке должна иметь вид "тип штрих-кода, номер", например "7, 123" (без кавычек, конечно). В этом случае система сформирует штрих-код: "2700000001233". Первая цифра - всегда 2, далее - указанный тип штрих-кода, нули, чтобы получилось 13 символов, номер, указанный в таблице, и один символ - контрольная сумма. Значение '''"2" - CODE128''' (с версии 734). Данные из первой строки ячейки таблицы печатаются в штрих-коде "как есть". Для всех видов штрих-кода (с версии 734) последующие строки печатаются под штрих-кодом в виде текста.

SetMultiHeader(Active) - Включает печать заголовка при переносе таблицы на несколько страниц. По умолчанию отключено.

SetCustomHeader(script) - Включает печать пользовательского заголовка. Script - это код интерпретатора, который должен печатать заголовок на канву. Печать таблицы может происходить на нескольких листах, по этому скрипт будет вызван для каждого листа. При использовании этого метода, автоматически инициализируются переменные: $TablePageNo - номер страницы, нумерация начинается с нуля; $TableY - координата по оси Y, от которой рисуется заголовок. Чтобы таблица была под заголовком необходимо значение переменной $TableY увеличить на высоту заголовка.

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

Пример:
<?>
NEW('TPrinter', 'Prn');
If(prn.ShowDialog,
NEW('TTable', 'Tbl');
NEW('TSelfADO', 'MyDB');
MyDB.Open('SELECT concat("7", ", ", a.code, "\r\n", a.client_id, "\r\n", a.zakaz, "-", a.number) as "Штрих-код", a.target AS "Заказик", address, phone, vlog, poruch FROM address a order by code desc limit 10');
Tbl.LoadFromDB(MyDB.Self);
Tbl.SetBarcode(1, 1);
Tbl.SetCustomHeader(
if($TablePageNo>0,
Prn.Canvas.TextOut(Prn.Canvas.DPIX*0.1, $TableY, 'Продолжение таблицы');
set($TableY, $TableY + Prn.Canvas.TextHeight('H'));
,0)
);
Prn.BeginDoc;
Prn.PrintTable(0, Tbl.Self);
Prn.EndDoc
, );

== Объект TBaseUtils ==

Предоставляет функции, базирующиеся на БД системы «MEASOFT». По-умолчанию, при создании подключается к основной базе данных модуля, в котором выполняется скрипт, если такая определена контекстом, однако это можно изменить, см SetConnection.

Функции:

'''MakeAddress(s[,town])''' – возвращает значение, полученное путем преобразований адреса s для приведения его к внутреннему формату программы. В процессе преобразования до нескольких раз происходит замена буквосочетаний по таблице замены (ее редактирование доступно по нажатию кнопки «Автозамена» в интерфейсе импорта БД из Excel системы (см. Руководство пользователя)), поиск улиц по базе КЛАДР с точностью до одного знака, и некоторые другие операции, нацеленные на исправление ошибок в написании адреса.

С версии программы 2008.0.0.615, при вызове функции в формулах загрузки реестра, в первую очередь происходит проверка строки s на условия:
* в строке s записано число;
* строка s начинается с "ПВЗ ".
Если одно из этих условий выполняется, то функция пытается установить пункт самовывоза - т.е она сама в загружаемой карточке корреспонденции укажет: адрес ПВЗ, город ПВЗ и установит галку самовывоз. Правила поиска ПВЗ:
* Если s число - считаем его внутренним кодом филиала;
* Если s начинается с "ПВЗ " - Например в адресе передана строка "ПВЗ На Ленинском проспекте", то искать будем филиал с названием "На Ленинском проспекте" который подчиненный, активный, с галкой ПВЗ и в городе town. Если город не указан, то ищем филиал во всех городах, и считаем его найденным если найдем только один филиал.
* Если филиалы найти не удалось, функция makeaddress работает как обычно и выполняет преобразование адреса.

Если адрес не содержит русских букв, только латиница, и курьерская служба находится в одной из стран Россия, Белоруссия, Казахстан или Украина, и город-получатель (второй параметр, town) находится так же в одной из этих стран, функция автоматически делает транслитерацию адреса на русский язык.

''SetConnection(DB) – Подключает объект к базе данных DB, где DB – ссылка на объект TADO.Self.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

''SetTown(Town) – Устанавливает код текущего города (используется в некоторых функциях объекта) в значение Town. По-умолчанию текущий город – 1.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

'''SetIndexLength(Length)''' – Устанавливает длину почтового индекса. По-умолчанию – 6.

'''GetIndex(Address)''' – Возвращает почтовый индекс из адреса.

'''GetStreet(Address)''' - Возвращает улицу до первой запятой.

'''GetHome(Address)''' - Возвращает номер дома до второй запятой, но не более пяти символов.

'''GetKurierByStation(station, Mass, Cash, Date_Putn)'''

'''TownByIndex(Index[, PriorityName][, PriorityCountry])''' – Возвращает код города по индексу. В случае ошибки поиска – код текущего города. Если нашлось несколько населенных пунктов, и указано приоритетное название - выбирается населенный пункт, название которого начинается с PriorityName (если есть).

'''TownByName(Name[,NotNeedCL=False, City=0])''' – Возвращает код города по имени. В случае ошибки поиска – возвратит код текущего города. Если параметр NotNeedCL (параметр не обязательный) установить в TRUE, тогда функция возвратит 0, если город не удалось найти. Параметр City (код региона) позволяет ограничить поиск одной областью (не обязательный, по умолчанию не используется).

'''FillClientInfo(Excel, client, Sheet, Row, Col)''' – Выводит в эксель информацию о клиенте с кодом client на лист sheet начиная со строки row и столбца col.

'''SavePrintFormToFile(FormType, FormNumber)''' - Сохраняет на диске файл печатной формы и возвращает путь к нему

'''CreateTrans(Address[, Store][, Operator][,Correction])''' - Формирует запись для печати кассового чека для корреспонденции с кодом Address, для выбора кассового аппарата используется код склада Store. Если Store не указано - при исполнении в среде клиентского модуля системы использует склад, указанный пользователем в окне [[Настройка параметров рабочего места|"Настройка" - "Параметры"]], в остальных модулях - код текущего склада из [[Настройка глобальных параметров|переменной]] "CL" ("Текущий филиал"). Поле Operator позволяет указать кассира (передается код справочника сотрудников). Если не указан, в основной системе будет использован код авторизованного пользователя, в других модулях - 1.
Поле Correction позволяет указать данные для корректировочного чека, используется в системе Штрих-М. По умолчанию пустая строка. Возвращает идентификаторы записей чеков. Может вернуть пустую строку, если чек создавать не понадобилось, один или несколько кодов через запятую, если создано несколько чеков. В случае ошибки вызывает ошибку, поэтому рекомендуется использовать с функцией Try.

'''CreateReturnTrans(Address)''' - формирует запись для печати чека возврата для корреспонденции с кодом Address. Чек возврата печатается на полную сумму и с теми же атрибутами, что и чек продажи. Возвращает идентификатор записи чека возврата. В случае ошибки вызывает ошибку, поэтому, как и с CreateTrans, рекомендуется использовать с функцией Try.

'''CalcTownDeliveryDays(Source, Mode, TownTo, TownFrom)''' - возвращает количество дней необходимых на доставку отправления, только для межгорода. Source - код клиента, Mode - режим срочности, TownFrom - код города отправителя, TownTo - код города получателя.

'''CalcDeliveryDate(Source, Mode, TownTo, TownFrom, Date_Beg, Time_beg)''' - Возвращает планируемую дату доставки с учетом сроков доставки. Работает при городской и междугородней доставке. Для межгорода сроки доставки берутся из зон. Для городской доставки, из дополнительных параметров статуса (17 статус, 1 параметр в доп. информации) Если рассчитать дату планируемой доставки не удалось, возвращает пустую строку. Параметры: Source - код клиента, Mode - режим срочности, TownTo - город получатель, TownFrom - город отправитель, date_beg - дата заказа (может быть передана строкой в формате DD.MM.YYYY или в числовом), time_beg - время заказа.

'''GenSpecialSMA(DirectExcel, Code)''' - функция для генерации отчета о доставке по акту передачи денег. Первый параметр - указатель на TDirectExcel, второй параметр - код акта передачи денег. АПД выводится на текущий лист объекта TDirectExcel.

'''CreateSpecialSMA(ClientCode, DateTo)''' - Функция создает исходящий акт передачи денег (АПД). Требует ClientCode - код клиента, DateTo - дату акта. Функция возвращает коды созданных актов. Если возвращаемых параметров два, значит функция пыталась создать два АПД: первым, идет код АПД с наличной оплатой, а вторым с безналичной. Примеры возвращаемого результата: '0'- акт не был создан, отсутствуют корреспонденции; '124' - код созданного акта; '0,0' - пытались создать два акта, но отсутствуют данные; '4556,0' - создан только наличный АПД; '0,445' - создан только безнал.; '4556,445' - созданы нал. и безнал.

'''CreateAddressForActDelivery(ActCode, [DeliveryDateMode=0, Delivery=True])''' - Функция создает корреспонденцию на доставку акта. ActCode - код акта; DeliveryDateMode: 0 - установить план. дату доставки текущим рабочим днем, 1 - установить план. дату доставки следующим рабочим днем, 2 - установить план. дату доставки равной планируемой дате оплаты АПД; Delivery - создать корр. на доставку АПД или создать корреспонденцию на забор АПД (по умолчанию, доставка АПД). Работа функции может быть изменена системной доп. возможностью OnCreateAddressForActDelivery.

'''CreateAddressTransferAct(ClientCode, Store, DateTo, [AdditionalParam])''' - Функция создает исходящий акт передачи корреспонденции (АПК). Требует ClientCode - код клиента, Store - код филиала, для которого будет создан акт, DateTo - дату, до которой в акт попадут возвраты, AdditionalParam - дополнительный строковый параметр для передачи в системную доп. возможность ExceptionsForAPK, позволяющий отобрать в акт, например, только полные возвраты. Возвращает код созданного акта. ВНИМАНИЕ: при создании АПК используется системная функция ExceptionsForAPK. Если в ней используются интерактивные функции (вывод сообщений, диалоговые окна, выполнение скриптов), то акт сформирован не будет, а функция CREATEADDRESSTRANSFERACT вернет ошибку.

'''GetPolygonByAddress(Address, TownCode, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попал адрес. Если полигон найти не удалось, функция возвратит пустую строку. Address - адрес корреспонденции текстом; TownCode - код города; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByAddress(addressrecord.address, if((addressrecord.number=0)*(addressrecord.strbarcode=<nowiki>''</nowiki>), addressrecord.townfrom, addressrecord.townto), '`schema`=1') - пытаемся найти вхождение адреса в полигоны 1 схемы, при выборе города учитывается корр. на забор, у нее нужно использовать город-отправитель (а для обычной корр. нужен город-получатель).

'''GetPolygonByLatLon(Lat, Lon, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попали GPS координаты. Если полигон найти не удалось, функция возвратит пустую строку. Lat - широта текстом; Lon - долгота текстом; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByLatLon('55.769064','37.590713','zone is not null and price=0') - пытаемся найти вхождение координат в полигоны, где задана зона, для всех клиентских и курьерских зон.

'''GetLatLonByAddress(AddressText, TownCode)''' - возвращает географические координаты вида lat,lon указанного в AddressText адреса. Поиск производится в городе, имеющем код TownCode в таблице Town.

'''GetRouteCode(AddressText, TownCode, LatLon[, Lon])''' - для адреса AddressText в городе с кодом TownCode (из таблицы Town) по географическим координатам lat, lon возвращает код роута (записи, хранящей координаты адреса в городе). Если роут не найден (для адреса в городе не найдено записи с указанными координатами) - создает новый роут и возвращает его код, если роут найден (был создан ранее) - обновляет у роута координаты. Если параметр Lon задан, то параметр LatLon должен содержать одну координату, иначе LatLon должен содержать строку вида 'lat, lon'.
В случае ошибки возвращает Null.

Пример: 
Set($res, GetRouteCode(address, townto, '55.114034, 36.592397')); 
Set($res, GetRouteCode('Троицк, Полковника милиции Курочкина ул., 11', 1, '37.467446, 55.740537')); 
Set($res, GetRouteCode('Обнинск, Маркса пр., 20', TownByName('Обнинск'), 55.114034, 36.592397));

'''CalcAgentPrice(AddressCode, AgentCode, TownFrom, TownTo, Mode, [, Count=1])''' - функция возвращает стоимость доставки рассчитанную по тарифу агента. AddressCode - код адреса, AgenCode - код филиала (агента), TownFrom - код города отправителя, TownTo - код города получателя, Mode - режим срочности, count - тарифная сетку от указанного количества отправлений (по умолчанию 1)

'''SetAddrKol_vo(address, getkol_vo)''' - функция делает прием корреспонденции в текущем ответственном филиале. address - внутренний код адреса, getkol_vo - количество принимаемых мест, может принимать значения: "kol_vo" - принять все места, "getKol_vo+1" - принять еще одно место, "число" - сделать количество принятых мест равным указанному числу.

'''CalcClientCnt(client_code, date, is_intown [, date_put=CurrDate(), skipajust=false])''' - функция расчета количество доставленных корреспонденций у клиента с кодом client_code за предыдущий месяц от даты date (Или за текущий месяц, подробнее смотри переменную UseCurrentMonthCount) среди внутригородских (is_intown = true) либо междугородних (is_intown = false) корреспонденций, date_put - дата доставки (для альтернативного способа подсчета, включаемого переменной UseDatePutForCalcCnt), skipajust - не учитывать принудительно введенные количества (таблица priceclientadjust типы записей 0 и 1).

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset._self".
Описание некоторых полей датасета:
pmoney - процент от суммы;
pmoneycard - процент от суммы при оплате картой;
pricecode - код прайса (таблица Price) ;
distarea - район метро получателя (актуально при отключённом едином районировании, как правило район от 200 до 299 является признаком области);
region - признак области при включенном едином районировании;
distareaFrom и regionFrom - аналог distarea, region только для отправителя;
pcncode - код записи таблицы pricecnt "количество от";
Запрос содержит поля таблицы pricelinesnew - начальная стоимость по тарифной сетки, найденные без учета массы,только по типу срочности и режиму.
Запрос содержит поля таблицы price.

*addressrecord - ссылка на объектную модель карточки корреспонденции, следует использовать уже созданную addressrecord._self
*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*type - тип корреспонденции;
*mode - режим доставки;
*wait - количество минут ожидания (не учитывается при доп. услугах, есть системная услуга "ожидание");
*mass - масса отправления;
*rur - сумма передаваемых денег (не учитывается при доп. услугах, есть системная услуга "процент от суммы");
*inshprice - сумма страховки (не учитывается при доп. услугах, есть системная услуга "процент от объявленной стоимости");
*distance - расстояние до места доставки, обычно поле заполняется при доставке в область (регион в едино районировании). Дополнительная наценка к стоимости доставки;
*forward - направление доставки: true - туда; false - обратно;
*Collection - признак заборной корреспонденции: true - забор, false - доставка (В тарифе есть возможность указать стоимость для забора);
*TownFrom - код города отправителя;
*TownTo - код города получателя.

В тарифе есть возможность указать формулу, которая может влиять на базовый расчет. Формула может объявить служебные переменные, которые:
*$FormulaReplace - если true – возвращаемое значение полностью заменяет базовый расчет;
*$FormulaKoeff - коэффициент на который будет помножена базовая стоимость.
Также внутри формулы объявлены следующие объекты dataset, addressrecord и переменные:
*$ForceIntown - Переменная становится истиной, если междугородний расчет был отменен, т.к. адрес попал в нарисованную зону на карте.
*а также: $forward, $distance, $Count, $Collection, $Wait, $FormulaKoeff, $PriceCode - описание есть выше.

Для направления "туда", Функция GetBasePrice вызывается через доп. услугу "База" (при включенных доп. услугах), для направления "Обратно" всегда вызывается напрямую (т.к. доп. услуги работают только в для направления "туда").
На расчет этой функции влияют следующие переменные: "Финансы" -> "Расчет стоимости по адресу", "Финансы" -> "Зона клиента по умолчанию", "Финансы" -> "Подсчет кол-ва отправлений за месяц".

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset.self".

*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*tp - тип корреспонденции;
*mode - режим доставки;
*mass - масса отправления;
*TownFrom - код города отправителя;
*TownTo - код города получателя.

'''CalcAddressPrice(AddressCode, [,ZakazCount])''' - полностью пересчитывает стоимость доставки корреспонденции по тарифу клиента. AddressCode - внутренний код адреса, ZakazCount - не обязательный параметр, кол-во заказов от клиента.

'''GetStationCode(s [,town])''' – возвращает код станции метро, ассоциированный в системе с адресом s. В случае невозможности идентифицировать станцию метро – возвращает 0.
Когда включено районирование по карте, необходим второй параметр "town" - код города в котором нужно искать адрес. Возвращает код района если удалось его найти; код станции меж-города - если адрес удалось геокодировать, но район не нашли; код 0 - когда не удалось геокодировать адрес.

'''RecalcSpecialSMA(ActCode)''' - пересчитать акт передачи денег (АПД). Также, у корреспонденций входящих в АПД будет пересчитана стоимость доставки. Для Входящего АПД сумма акта не пересчитывается. Параметр ActCode - внутренний код акта, коды можно перечислять через запятую.

'''UserCode''' - Возвращает код текущего пользователя из таблицы «Пользователи» (users).

'''UserName''' - Возвращает имя текущего пользователя из таблицы «Пользователи» (users).

'''UserPass''' - Возвращает пароль текущего пользователя.

'''UserBaseCode''' – Возвращает код текущего пользователя из таблицы «Сотрудники» (kurier).

'''UserEmail''' - Возвращает e-mail текущего пользователя.

'''CurrentTown''' – Возвращает код текущего города (из таблицы town).

'''CurrentCity''' – Возвращает код текущего региона (из таблицы city).

'''CurrentLocation''' – Возвращает код текущего филиала (из таблицы store).

'''FromEmailStr''' - строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

'''FillExcelDoc'''(Excel, Dataset, FormType, FormNumber,Print,[printer]) - Выполняет указанную печатную форму в объекте excel. Excel объект можно не указывать, тогда функция сама создаст объект экселя и разрушит его, полезно когда книгу
нужно распечатать или отправить по email (на листе данных в ячейке 1,1 укажите ключевое слово email). Dataset объект с данными для скрипта в печатной форме, может быть null. Dataset передавать можно так db.self, тогда переданный dataset внутри печатной формы будет доступен по имени dataset. Print - печатает книгу на принтере, после печати объект excel разрушается, при использовании параметра не указываете объект excel. Printer - имя принтера, на котором печатать (по умолчанию пустая строка, что означает "печатать на принтере по умолчанию"). Например:

new('TExcel', 'excel');
FillExcelDoc(excel.self, null, 12, 1);
excel.DoNotDestroy(true);
excel.SetVisible(true);
''Покажет эксель с выполненной печатной формой''

'''ValutaSign''' – Возвращает название валюты для суммы.

'''SendToMeasoft(xml)''' - Отправляет запрос в клиентское API Measoft. Автоматически добавляет начальный "<?xml version="1.0" encoding="utf-8"?>".

'''InsertFirmAtt(excel, sheet, firmcode)''' - Вставляем на лист эксель по коду фирмы: печать, подпись, подпись бухгалтера, логотип. Тэги <STAMP>, <DIR>, <BUH>, <LOGO> соответственно. После тега можно указать размеры изображения в символах Microsoft Excel. Формат записи: <STAMP> 16, 16

'''PreCalcSalary(kurier, addressCodes)''' - Рассчитывает предварительную зарплату. Kurier - код курьера, используется для определения тарифа. addressCodes - коды адресов, через запятую для которых необходимо посчитать зарплату. Результаты расчета будут записаны в таблицу kurierpaydetail, так как расчет предварительный то записи не будут прикреплены к конкретному начислению.

select a.code, kpd.price as "туда", kpd2.price as "обратно" from address a
left join kurierpaydetail kpd on kpd.sourcetable=3 and kpd.sourcecode=a.code and kpd.rectype = 1
left join kurierpaydetail kpd2 on kpd2.sourcetable=3 and kpd2.sourcecode=a.code and kpd2.rectype = 2
where a.code in (...)

'''CalcSalary(DateTo, [Filter=0, KurierCode = 0, ManagerCode = 0])''' - Полный расчет зарплаты курьерам. DateTo - дата до которой создается начисление. Условия отбора курьеров для начисления. Filter - роль сотрудника: 0 - Все, 1 - курьеры, 2 - менеджеры; KurierCode - код курьера, ограничить расчет зарплаты одним курьером;ManagerCode - код курьера, ограничить расчет зарплаты курьерами указанного менеджера. Внимание фильтры Filter, KurierCode и ManagerCode накладываются друг на друга. Результатом функции является SubSQL с информацией по созданным начислениям.
поля ответа: код курьера, код менеджера, начислено, бонусы, штрафы, аванс, итого;
select kurier, manager, profit, bonus, shtraf, prepay, total [union select ...]

'''SelDistAddr(s)''' – Возвращает строку для вставки в select запрос, для вывода поля с упрощенным адресом. Принимает один необязательный строковый параметр - алиас таблицы из которой будет упрощаться поле address, по умолчанию "a"

'''VoiceReadStr(str)''' – Озвучивает фразу str голосовым уведомлением доступными словами из базы. Может содержать тег "{break_off}" для того, чтобы сделать эту фразу не пропускаемой в очереди воспроизведения.

'''CalcStorageCost(ClientCodes, DateFrom, DateTo, NeedReport[, Store])''' – рассчитывает стоимость хранения на складе для выбранных клиентов (ClientCodes - коды клиентов через запятую), в период дат с DateFrom до DateTo, с прикреплением к корреспонденции отчета в зависимости от выставленного параметра NeedReport. Может содержать параметр Store - код филиала, по умолчанию пустой (расчет выполняется для всех филиалов). Возвращает коды созданных корреспонденций через запятую.

'''WriteOut(DocId, ItemId, Date, Cnt[, BC])''' – производит списание товара со склада. DocId - код (docs.code) документа списания, ItemId - код товара (item.code), Date - дата операции, Cnt - количество списываемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер. Если указан BC, то параметр ItemId игнорируется и поиск номенклатуры происходит исключительно по штрих-коду. В случае успеха, функция возвращает строку вида: код номенклатуры, списанное кол-во.

'''IncomePurch(DocId, ItemId, Date, Cnt[, BC, Location = CurrentLocation])''' – производит приход товара на склад. DocId - код (docs.code) приходной накладной, ItemId - код товара (item.code), Date - дата операции, Cnt - количество приходуемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер, Location - код склада (store.code). В случае успеха, функция возвращает строку вида: код номенклатуры, введенное кол-во.

'''CreateLedgerDoc(Date, Client, UserCode, Type[, ExtNumber, Message])''' - создает складской документ и возвращает код этого документа. Date - дата документа. Client - код клиента. UserCode - код пользователя, создавшего документ. Type - тип документа (statetype = 13). ExtNumber - номер у поставщика для документов прихода и расхода. Message - комментарий к документу. Последние два аргумента не обязательные и могут быть пустыми.

== Объект TINIFile ==

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

Функции:

IniParam(s[,section='common']) – Существует только если имя экземпляра объекта пустое. Возвращает значение параметра s ini-файла секции «common», изменить секцию можно не обязательным параметром section. В случае отсутствия параметра в файле возвращает пустую строку.

Param(s) – Синоним IniParam с тем отличием, что существует только если имя объекта непустое.

SetText(s) - Загружает ini файл из строки s. Если в файле нет секции «common», то принудительно объявляет ее в начале.

== Объект TSMS ==

Предназначен для отправки SMS, а также проверки статуса их доставки.

Функции:

SetProxy(Server, Port, User, Pass) - Устанавливает настройки прокси-сервера.

Connect(Provider, Host, User, Pass, SenderName, SMSPrefix) – Подключает объект к провайдеру provider, используя адрес Host, имя пользователя User и пароль Pass. Значение SMSPrefix предназначено для того, чтобы провайдер мог различить сообщения от разных филиалов, если этими филиалами используется одно подключение. Если необходимости разделять сообщения нет - значение SMSPrefix можно не указывать.
Для провайдера доступны значения 'mirsms', 'sms16', 'websms', 'epochta', 'zanzara', 'SMSManager', 'f1sms', 'BitCall', 'mirsmsGET', 'AMD' и другие, либо можно указать числовые значения номера протокола, от 1 до <rspoiler text="20">Набор провайдеров все время дополняется, количество и номера можно смотреть в Справочники - Переменные - Подключения - SMS</rspoiler> соответственно. Эти значения соответствуют значениям переменной SMSProtocol таблицы "Value".

SendSMS(Phone, Text, [ID]) – Отправляет SMS с текстом Text на телефон Phone. Для некоторых провайдеров необходим уникальный идентификатор сообщения ID (для провайдера iVoice - идентификатор сценария (кампании)). Возвращает ID провайдера для последующей проверки статуса доставки.

CheckSMS(ProviderID) – Проверяет состояние доставки сообщения с идентификатором ProviderID. Возвращает: 0 – доставляется, 1 – успешно доставлено, 2 – не доставлено.

ReceiveSMS(InboxID, DateFrom, DateTo, NewOnly) - Получает входящие SMS, с ящика InboxID (идентификатор выдаётся провайдером). DateFrom, DateTo - задается временной интервал в котором были приняты сообщения(формат 08.04.2013 18:00:00 'DD.MM.YYYY HH:NN:SS'). Чтобы получать только новые сообщение поле NewOnly должно быть True. Возвращает XML с сообщениями.

ExtraResult([ParamName='']) - Вызывается после CheckSMS, возвращает дополнительную информацию по последнему статусу смс. В настоящее время работает только для провайдеров BitCall и iVoice. Для BitCall по умолчанию возвращает кнопки, нажатые абонентом во время работы с голосовым меню. Если в paramname указать 'IdentifyText' то будет возвращен JSON с ответами абонента на заданные вопросы(используется в случае звонков с индивидуальным сценарием). Для iVoice по умолчанию подразумевается параметр 'response', при этом будет возвращен JSON с ответами абонента на заданные вопросы (в зависимости от сценария)

Log - Возвращает последний HTTP запрос и ответ от сервера смс.

== Объект TXML ==

Предназачен для парсинга XML-данных.

Функции:

SetText(S) – Задает текст XML документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию. Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

AttribCount – Возвращает количество атрибутов текущего элемента.

AttribName(i) – Возвращает имя атрибута с номером i.

Attrib(V) – Ищет атрибут и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

Reset – Делает текущим корневой элемент, возвращает его значение.

== Объект TJSON ==

Предназачен для парсинга JSON-данных.

Функции:

SetText(S) – Задает текст JSON документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Можно проверять наличие элементов, если элемента нет, вернется пустая строка.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

Reset – Делает текущим корневой элемент, возвращает его значение.

isArray - Возвращает true, если текущий элемент является массивом (доступ к дочерним элементам возможен только по индексу, нумерация элементов начинается с нуля)

==Объект TZip==
Предназначен для работы с Zip архивом.

SetZip(s) - Загружает архив в объект из строки s;

GetZip - Возвращает архив в виде строки;

AddFromFile(SrcPath, ZipPath) - Добавляет файл SrcPath в архив и располагает его по пути ZipPath. ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

AddFromStr(Data, /*ZipPath*/) - '''параметр ZipPath временно не работает'''. Добавляет файл из строки Data в архив и располагает его по пути ZipPath. -ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

LoadFromFile(path) - Загружает архив из файла path;

SaveToFile(path) - Сохраняет архив в файл path;

Count - Возвращает кол-во файлов в архиве;

DataByIndex(index) - Возвращает распакованный файл в виде строки. Index - номер файла в архиве;

DataByName(ZipPath) - Возвращает распакованный файл в виде строки. ZipPath - путь к файлу в архиве, может содержать каталоги;

FileName(index) - По номеру файла, функция возвращает полный путь файла в архиве.

==Объект TBase==

'''Функции общего назначения''':

'''ExecSimpleScript(Caption, Text)''' - Выполняет скрипт "Дополнительных возможностей". Возвращаемые значения, введенные пользователем устанавливает в переменные $scriptvar1..$scriptvarN, Значения кодов списочных переменных - в переменных $scriptvar1codes..$scriptvarNcodes. Функция возвращает истину, если пользователь нажал "OK" в диалоговом окне.

'''FillAdvPriceReport(Excel, AddressCodes, StartLine, StartCol, [ShowSumPrice,InsertColumns,ShowAll])''' - добавляет отчёт по дополнительным услугам. В AddressCodes - указаны коды адресов через запятую, каждый код это отдельная строка отчета. Адреса будут показаны в порядке перечисления их в AddressCodes. Если в отчет нужно добавить пустую строку, то можно указать код адреса -1000. StartLine, StartCol - верхний левый угол выгружаемой таблицы. ShowSumPrice - добавить столбец итоговый столбец с суммой всех услуг, по умолчанию выключено. InsertColumns - раздвинуть таблицу перед вставкой отчета, позволяет встраивать отчет посередине выгрузки, по умолчанию выключено. ShowAll - показать все дополнительные услуги, по умолчанию false и показывает только услуги с начислениями. Функция возвращает количество использованных столбцов.

'''PrintSticker(Codes, [ToBoxes=False])'''

'''PrintBlanc(Codes, BlancNumber)''' - печатать форму из раздела "Заполнить бланк". Codes - коды корреспонденций, BlancNumber - номер формы из раздела "Бланки для корреспонденции" (3)

'''GetItemByName(Name)'''

'''GetA4Printer''' - возвращает имя принтера выбранного для печати документов

'''GetStickerPrinter''' - возвращает имя принтера выбранного для печати стикеров

'''GetDuplexPrinter''' - возвращает имя принтера выбранного для двусторонней печати, если принтер не выбран, возвращает пустую строку

'''PrintAttachPDFPage(Code, FileName, Page, Printer)''' - печатает страницу из вложенного файла PDF. Code - код вложения (attachment) или путь к файлу, Page - номер страницы, Printer - 0 = принтер A4, 1 = принтер этикеток.

'''AttachPDFToText(Code, [TextFileName])''' - преобразует файл PDF из вложений в текст. Code - код вложения (attachment) или путь к файлу, TextFileName - имя текстового файла, в который записывается результат (если не указан, используется временный файл). Возвращает текст в виде строки.

'''GhostScript(GScript, Code)''' — функция для выполнения консольных команд утилиты [https://ghostscript.readthedocs.io/en/latest/Use.html ghostscript]. Где, GScript — строка с командами Ghostscript; Code — код вложения или путь к PDF-файлу, предназначенному для обработки. В командах доступен специальный тег %MeasoftInFile%, который автоматически заменяется на путь к предварительно загруженному файлу (Code). Если в команде необходимо указать путь для сохранения результата обработки, используйте тег %MeasoftOutFile%. В этом случае функция на основании параметра Code автоматически сформирует имя временного выходного файла. После успешного выполнения команд функция возвращает путь к сгенерированному выходному файлу - %MeasoftOutFile%.

'''GetActiveForm([SkipFormName])''' - возвращает код активной формы в программе где происходит сканирование. SkipFormName - не обязательны параметр, имя формы которую нужно пропустить при определении интерфейса.
'''Список интерфейсов''':
0 - неопределенный;
1 - прием корреспонденции на склад;
2 - АПД;
3 - комплектация адресов (ShelfingForm);
4 - доска приема;
9 - вкладка «Манифесты»;
10 - Инвентаризация корреспонденции;
11 - АПК;
12 - вкладка «Адреса»;
13 - вкладка «Выдача»;
14 - вкладка «Склад»;
15 - Список номенклатуры;
16 - Инвентаризация склада;
17 - Приходная накладная;
18 - Списание товара;
19 - Карточка корреспонденции.

'''AddAddressScanLog(Code[, StrBarCode, IsManual, FromInterface, ExtraInfo])''' - добавляет событие сканирование для корреспонденции с кодом Code. Необязательные параметры: StrBarCode - сканируемый ШК корреспонденции (по умолчанию пустой), IsManual - галка ручного сканирования (по умолчанию false), FromInterface - код интерфейса сканирования (StateType=81, по умолчанию 0 - неопределенный), ExtraInfo - текстовый комментарий события.

'''RuleName(alias)''' - Выдает полный путь в дерева прав по псевдониму права.

'''ShowText(Caption:string, Value:string)''' - показывает пользователю окно с заголовком Caption и с многострочным полем со значением Value. Может быть полезен при отображении логов выполненной операции.

'''ShowScanError(msg [, Speek, Color, Abort])''' - выдает пользователю окно с текстом msg блокируя последующие действия сканирования. Если Speek - истинно, то сообщение проговаривается голосовым движком, по умолчанию выключено. Color - целочисленное число цвета, в который будет окрашен фон сообщения (по умолчанию = -1, стандартный). Abort - прервать выполнение скрипта, не показывая ошибку.

'''CheckRule(alias)''' - функция проверки разрешения у текущего пользователя системы, alias - псевдоним права. Возвращает 1, если право есть и 0, если права нет.
Пример: if(CheckRule('RSE'), ShowMessage('У пользователя есть право изменять счета'), ShowMessage('У пользователя нет права изменять счета'));

'''GetKurierMoney(KurierCode, DateEnd, NonCash)''' - возвращает баланс курьера с кодом KurierCode на дату DateEnd. NonCash - булевый флаг, если истинно, то будет рассчитан безнальный баланс;

'''Функции, работающие только в импорте БД из эксель:'''

ReplaceAddress

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

GetPrice

GetNewNumber - используется при импорте реестра, возвращает номер конверта в загружаемом заказе

GetNewPos - используется при импорте реестра, возвращает порядковый номер вложения

GetNewPackagePos- используется при импорте реестра, возвращает порядковый номер места

Zakaz - возвращает номер заказа куда происходит импорт реестра

addresscode - используется при импорте реестра, код созданного адреса

Source - код заказчика

ClientTown - Узнаем город клиента, через филиал с которым он работает. Сам клиент берется из заказа указанного в окне "Импорт БД из Excel".

== Объект TFieldObject ==
Создается только автоматически. Объект для доступа к записям, используется в картах и дополнительных услугах (addressrecord) и событиях карточки корреспонденции (fieldlist). Методы объекта:

'''_GetTableInfo''' - возвращает данные о полях и примеры данных объекта.

'''_Self''' - возвращает ссылку на объект.

'''_Set(fieldname, fieldvalue [, DoUpdateForm])''' - Если базовый объект строка. Устаналивает для поля fieldname значение fieldvalue. DoUpdateForm по уолчанию false, если указать true то обновление поля будет не только в объекте но и пользовательском интерфейсе. Обновление работает только в карточке корреспнденции для ограниченного набора полей: vlog, mode, type, date_put, time_put, message, kurier, state1.

'''_Set(keyfield, keyvalue, filed, value)''' - Если базовый объект таблица (addressrecord.boxes). Работает перегруженная версия метода _set, cначала происходит поиск строки по ключу, далее меняется значение указанного столбца. keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Пример, отключение услуги база:

addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

== Объект TMessage ==
Создается только автоматически. Объект используется для скриптовой обработки письма в [https://wiki.courierexe.ru/index.php/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F_%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8#.D0.98.D0.BC.D0.BF.D0.BE.D1.80.D1.82_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85| заданиях импорта данных]. В себе содержит текст письма в очищенном формате и оригинальном формате HTML, отправитель письма, тему письма, дата получения и список прикрепленных файлов.

'''Message.Text''' - возвращает очищенный от HTML-тегов текст письма.

'''Message.HTMLText''' - возвращает оригинальный текст письма со всеми HTML-тегами.

'''Message.Sender''' - возвращает email-адрес отправителя письма.

'''Message.AttachmentsCount''' - возвращает количество вложенных файлов.

'''Message.DateTime''' - возвращает дату и время получения письма.

'''Message.Subject''' - возвращает тему письма.

'''Message.GetAttachmentDataString(Number)''' - возвращает вложенный файл под номером Number в виде строки.

'''Message.GetAttachmentName(Number)''' - возвращает имя вложенного файла под номером Number.

== Объект TStringList ==
Может использоваться для построчной обработки многостраничных файлов либо для организации текстовых данных. Номер строк начинается с 0.
Имеет следующий функционал:

'''Count''' - возвращает количество строк в списке.

'''Add(Value:string)''' - добавляет значение Value в конец списка.

'''SetText(Value:string)''' - устанавливает значение списка в значение Value.

'''Insert(Number:integer, Value:string)''' - добавляет строку Value в позицию Number.

'''Delete(Number:integer)''' - удаляет строку из списка в позиции Number.

'''Clear''' - очищает элементы списка.

'''LoadFromFile(Path:string)''' - загружает текстовый файл по пути Path.

'''Strings(Number:integer)''' - возвращает строку с номером Number.

'''SetString(Number:integer, Value:string)''' - устанавливает значение строки с номером Number в значение Value.

'''Text''' - возвращает полный список строк в виде текста.

'''CommaText([Quoted:boolean])''' - возвращает список значений через запятую. Если Quoted = true, то квотирует элементы списка. По умолчанию равен false.

'''SetCommaText(Value: string)''' - разбивает значение Value на отдельные строки и кладет в список. Разделитель - запятые.

'''IndexOf(Value:string)''' - ищет значение Value среди элементов списка и если находит, то возвращает номер строки. Возвращает -1 если значение не было найдено.

'''Sorted(Value:boolean)''' - устанавливает флаг отсортированности списка в Value. Если Value = true, то сразу же его сортирует. По умолчанию Value = false.

'''Exchange(Pos1:integer, Pos2:integer)''' - меняет элементы списка с позициями Pos1 и Pos2 местами.

'''Duplicates(Value:integer)''' - изменяет параметр управления дубликатами в списке. Если Value = 0 (значение по умолчанию), то список не реагирует на дубликаты. Если Value = 1, то список при добавлении будет игнорировать дубликаты. Если Value = 2, то список будет выдавать исключение, при добавлении дубликата в список.

'''ParamName(Number:integer[, Delimiter:string])''' - возвращает текст до первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает пустоту.

'''ParamValue(Number:integer[, Delimiter:string])''' - возвращает текст после первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает всю строку.

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

Основные методы:

'''New'''(FuncName, Param1, Param2, ..., Body) — создание новой функции.Функция возвращает результат выполнения последней команды в теле функции. Аргументы:
* `FuncName` — имя функции (строка)
* `Param1, Param2, ...` — имена параметров функции (переменные начинаются с `$`, объекты — без префикса)
* `Body` — тело функции (скрипт, выполняемый при вызове)

'''FuncName'''(Arg1, Arg2, ...) — вызов созданной функции по имени. Если в объявлении была указана тип переменная, то и подставлять в аргумент надо обязательно переменную. Будет передано значение этой переменной (переменные словарине поддерживаются!). Если был объявлен объект, то указатель на объект должен быть получен через метод '''_self'''. C функциями поддерживают работу следующие классы: TExcel, TDirectExcel, TCSVFile, TADO, TSelfADO, TPrinter, TCanvas, TPicture, TTable, TINIFile, TSMS, TXML, TJSON, TZip, TStringList, TBaseUtils, а также объект addressrecord (TFieldObject). Результатом работы функции может быть число или строка.

Пример 1, обработка результатов функции:
<source>
<?>
new('TFunc', 'calc');
calc.new('Sum', '$a', '$b',
$a + $b
);

set($x, 10);
set($y, 20);
showmessage(calc.Sum($x, $y));
</source>

Пример 2, передача объекта в функцию:
<source>
<?>
new('TFunc', 'utils');
utils.new('ProcessDB', 'dbConn', '$value',
showmessage($value);
dbConn.open('SELECT * FROM address limit 3 ');
if(dbConn.recordcount > 0,
showmessage('Найдено записей: ' + dbConn.recordcount);
dbConn.first;
while(dbConn.eof = 0,
showmessage(dbConn.fieldbyname('code'));
dbConn.next
)
,0)
);

new('TSelfADO', 'db');
utils.ProcessDB(db._self,'test!');
</source>

== Применение языка формул ==
'''в различных контекстах системы «MEASOFT» и сопутствующих проектах'''

=== MEASOFT ===

==== Дополнительная информация на чеке ====

В карточке клиента на закладке «Касса» имеется поле для ввода текста, который будет отображаться на кассовых чеках, печатаемых для корреспонденции от данного клиента. В поле может быть введен как просто текст, так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TSelfDB с открытым набором данных со строчкой корреспонденции, заказа и клиента, на которую печатается чек

TBaseSupport

TBaseValue

Все объекты создаются с пустыми именами.

Так же система записывает в переменную $CashRegisterID вычисленный код фискального регистратора, на котором предполагается печать чека.

Результат работы скрипта печатается на создаваемом чеке, если скрипт не возвращает значение “-1” (число или текст) – в этом случае система чек не создает. Подразумевается, что либо скриптом было принято решение об отсутствии необходимости формирования чека, либо скрипт взял эту функцию на себя.

==== Заполнение шаблонов печатных форм ====

==== Дополнительные возможности ====

==== Импорт БД из Excel ====
В окружении интерпретатора создается объект ZakazRecord, он является списком со значениями таблицы zakaz. Именно в этот заказ будут загружены данные. Из этого объекта также доступно : 
*ZakazRecord.userfields - пользовательские поля заказа;
*ZakazRecord.Clients - данные таблицы clients;
*ZakazRecord.Clients.userfields - пользовательские поля заказчика.

==== Прайс лист клиента ====

Формула возвращает сумму в валюте клиента для каждой поездки (туда или обратно) единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Помимо стандартных объектов, система создает объект AddressRecord, в котором, как свойства, доступны все поля текущей записи. Так же она выставляет значение переменной $Forward в 1 (истина), если необходимо произвести расчет для направления "Туда" и 0 (ложь) - если обратно. ВНИМАНИЕ! Как и во всех остальных местах, после формулы нельзя ставить ";", иначе скрипт вернет 0!

Например:

if(int(AddressRecord.Time_Put_Max)>19, 100, 0)

''Прибавляет 100 рублей в случае, если максимальный срок доставки 20 часов или более''

if(pos(AddressRecord.Address, 'Аренда')>0,
set($FormulaReplace, 1);
1500
, 0)

''В случае наличия подстроки "Аренда" в адресе заменяет штатное ценообразование на 1500 рублей''

Объект AddressRecord может предоставить доступ к связанным таблицам :
* addressrecord.boxes
* addressrecord.packages
* addressrecord.clients
* addressrecord.price
* addressrecord.advprice
* addressrecord.userfields
* addressrecord.addressfld
* addressrecord.clients.userfields
* addressrecord.price.userfields
* addressrecord.zakaz
* addressrecord.zakaz.userfields

Чтобы получить доступ к полю VarCode из таблицы userfields необходимо записать AddressRecord.Userfields.VarCode. В присоединённой таблице может быть несколько записей чтобы получить к ним доступ предусмотрены функции _First, _EOF, _Next, _RecordCount, _Set.

Пример:
set($value1, 0); set($value2, 0);
while(AddressRecord.userfields._EOF=0,
if(AddressRecord.userfields.varCode=1,
set($value1, if(AddressRecord.userFields.VarValue='Праздничная упаковка', 150, 0)), ''''''');
if(AddressRecord.userfields.varCode=2,
set($value2, AddressRecord.userFields.VarValue), ''''''');
AddressRecord.userFields._Next;
);
int($value1) + int($value2)

Пример делающий тоже самое что и выше но через поиск Locate:
set($value1, if(addressrecord.userfields.VarValue('VarCode', 1)='Праздничная упаковка', 150, 0));
set($value2, int(addressrecord.userfields.VarValue('VarCode', 2)));
$value1 + $value2

В скрипте доступны переменные:
«$FormulaKoeff» - это коэффициент на который умножится конечная цена (по умолчанию равна 1);
«$PriceCode» - код прайса;
«$CurrentPriceConf» - код услуги;
«$BasePrice» - стоимость всех услуг с уровнем (pricelevel) меньше текущего.

Для вызова функции CalcBasePrice (Расчёт базовой цены) в скрипте объявленны переменные: $Count,$Collection,$Distance,$Wait.

Существует поиск по ключевому полю (поиск регистронезависимый), например чтобы найти в таблице advprice введённое значение для текущей услуги, нужно сделать такую запись addressrecord.advprice.value('priceconf', $CurrentPriceConf) - Первый параметр это ключевое поле, второй искомое значение. Если запись найдётся будет возвращено значение поле value, если нет функция вернёт значение 0.

Пример
if(addressrecord.advprice.active('priceconf', 3)='T', addressrecord.advprice.price, 0)

''Смотрим включена ли услуга и если да, возвращаем рассчитанную стоимость

Чтобы изменить значение записанное в объект addressrecord, нужно воспользоваться методом _set(keyfield, keyvalue, filed, value). Параметр keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Сначала происходит поиск строки по ключу, далее меняется значение указанного столбца.
Пример, отключение услуги база:
addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

Также существует упрощенный метод _set, с двумя параметрами filed, value - он используется в шаблонах загрузки или в системных доп. возможностях где доступен объект addressrecord.

==== Зарплата курьеров ====

Формула возвращает сумму в основной валюте для каждой единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Переменные «$FormulaTablKoeff» и «$FormulaMoneyKoeff» позволяют установить повышающий или понижающий коэффициент на стоимость доставки (по тарифной сетке) и услуги соответственно (процент от суммы, процент от стоимости доставки, ожидание). Переменная «$UsingZoneName» и «$KurierZone» содержат название и код зоны соответственно, есть возможность поменять название зоны для отчета.

=== Планировщик ===

В поле текста задания может быть введен как текст с командами планировщика (см ниже), так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TIniFile, Указывает на настроечный ini-файл планировщика.

Все объекты создаются с пустыми именами.

Для записи в лог планировщика нужно использовать функцию Print

=== Репликатор ===

== Прочее ==
ReplaceAddress(target, address) – Возвращает адрес последней доставки корреспонденции получателю target по адресу address от текущего клиента. При отсутствии такой доставки, возвращает address.

GetPrice –возвращает рассчитанное значение цены, на основе прайс-листа клиента и данных о корреспонденции.

GetKurierByStation(i) – возвращает код курьера, ассоциированного со станцией метро с кодом i.

GetNewNumber – Возвращает не занятый номер единицы корреспонденции в текущем заказе.

==История изменений==

=== Недавние изменения ===
{|
||'''Добавлено:'''
|2026.0.0.547 Доработка функций ATTACHPDFTOTEXT и PRINTATTACHPDFPAGE, добавлена возможность указать путь к файлу
|-
||'''Добавлено:'''
|2025.0.0.539 Добавлена поддержка отладчика AttachDebugger
|-
||'''Добавлено:'''
|2025.0.0.534 Добавлена поддержка оператора CASE и класса TFunc
|-
|}

=== Версия 2021.0.0.57 от 18.06.2019 ===
{|
||'''Добавлено:'''
|В объект TExcel добавлен метод ColumnDelete.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция InsertFirmAtt.
|-
||'''Добавлено:'''
||В объект TExcel добавлен метод Align.
|-
||'''Добавлено:'''
|Функция CheckEan
|-
||'''Добавлено:'''
|В объект функцию FillAdvPriceReport добавлены параметры ShowSumPrice,InsertColumns
|-
||'''Добавлено:'''
|В объект TSMS добавлен метод Log.
|-
||'''Добавлено:'''
|Добавлена функция Money.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция ValutaSign.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция GetPolygonByLatLon.
|-
||'''Добавлено:'''
|В объект TTable добавлена функция SetMultiHeader, SetCustomHeader.
|-
||'''Добавлено:'''
|Функция DownloadAttachment
|-
||'''Добавлено:'''
|В функцию SetRowHeight объекта TExcel добавлен параметр cnt.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция AsString.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция SetSize.
|-
||'''Добавлено:'''
|В объект TADO добавлена функция ParseForIn.
|-
||'''Изменено:'''
|В объект TBaseUtils из TBase перенесена функция FillExcelDoc.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция CalcAddressPrice
|-
||'''Изменено:'''
|Все функции класса TBaseSupport перенесены в TBaseUtils. Класс TBaseSupport больше не существует.
|-
||'''Добавлено:'''
|В функции RowInsert и RowDelete объекта TExcel добавлен параметр count.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция SendToMeaSoft
|-
||'''Добавлено:'''
|В объект TBaseUtils функция RecalcSpecialSMA
|-
||'''Добавлено:'''
|Новая функция Reverse
|}

=== Версия 849   22.02.2018 ===

{|
||'''Добавлено:'''
|В функцию TBaseUtils.TownByIndex добавлен параметр PriorityName
|-
||'''Добавлено:'''
|В объекте TBase добавлена функция GetNewPackagePos
|-
||'''Добавлено:'''
|В объекте TSMS доработан метод ExtraResult, добавлен параметр ParamName
|-
||'''Добавлено:'''
|В объект TBase добавлена функция CalcAgentPrice
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateAddressForActDelivery
|-
||'''Изменено:'''
|Функция CalcTownDeliveryDate заменена на CalcDeliveryDate
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateSpecialSMA
|-
||'''Добавлено:'''
|Функция SignatureUrl
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция LoadFromStr.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetPen.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetBrush.
|-
||'''Добавлено:'''
|В объект TPicture добавлена поддержка чтения в формате PNG.
|-
||'''Добавлено:'''
|В функцию TCanvas.DrawPic параметр Mode
|-
||'''Добавлено:'''
|Свойство TPicture.Canvas
|-
||'''Добавлено:'''
|Функция DeleteFile
|}

=== Версия 758   29.03.2017 ===
{|
||'''Добавлено:'''
|Функция GetPolygonByAddress
|-
||'''Добавлено:'''
|Функция ParamsCount
|-
||'''Добавлено:'''
|Объект TZip
|-
||'''Изменено:'''
|Функции CreateEAN и Create128 заменены одной функцией CreateBar, полностью совместимой с Create128, но добавлена поддержка EAN-13 и Interleaved 2-5 (для Почты России). В системе функции оставлены для обратной совместимости, но более не являются документированными и рекомендованными к использованию.
|-
||'''Добавлено:'''
|Параметр text в функцию Cell объекта TExcel
|-
||'''Добавлено:'''
|Функция UrlEncode
|-
||'''Добавлено:'''
|Функция IncDay теперь может принимать параметр count
|-
||'''Добавлено:'''
|Функции FtpGet, FtpPut, TTable.SetCell()
|}

=== Версия 452   26.02.2014 ===

{|
||'''Добавлено:'''
|Функция Time
|-
||'''Добавлено:'''
|Функция FixedIntToStr
|-
||'''Добавлено:'''
|Функция TimePeriod
|-
|'''Добавлено:'''
|В интерпретатор добавлена функция приёма смс - ReceiveSMS
|-
|'''Добавлено:'''
|Функция STR2UTF
|-
|'''Добавлено:'''
|Функция SAVETOFILE
|-
|'''Добавлено:'''
|Функция TExcel.SetSheetName
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "FILESTR"
|-
|'''Добавлено:'''
|Расширены возможности объекта addressrecord в формулах тарифов
|}

=== Версия 308   24.11.2012 ===

{|
|'''Добавлено:'''
|В функции загрузки таблиц из TADO добавлено условие, что поля, названия которых начинаются с "-" не выгружаются. Таким образом можно скрывать служебные поля из результирующего набора.
|-
|'''Добавлено:'''
|Функция TExcel.RowAutoFit
|-
|'''Добавлено:'''
|Функция TExcel.RowInsert
|}

=== Версия 300   01.11.2012 ===

{|
|'''Добавлено:'''
|В объекте TCSVFile добавилась возможность запрашивать значения не только текущей записи через параметр сдвига
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "UPDOWN"
|-
|'''Добавлено:'''
|В интерпретатор добавлен объект TCSVFile
|}

=== Версия 266   14.09.2012 ===

{|
|'''Добавлено:'''
|В интерпретатор добавлена поддержка массивов
|}

=== Версия 265   11.09.2012 ===

{|
|'''Добавлено:'''
|Функция CreateTrans в интерпретатор
|-

Руководство программиста

2026-01-13T17:14:17Z

Sammy: /* Объект TBase */

== Основные положения ==

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

Как интерпретатор приводит типы:

1. При использовании значения как параметр функции интерпретатор автоматически приводит значение к типу, необходимому функции.

2. При операциях сложения, а также логических операциях, операнды приводятся к строке если хотя бы один из них имеет тип «строка». Например:
3.3+5 -> 8.3
‘3.3’+5 -> ‘3.35’
подобную проблему можно решить принудительно преобразовав тип:
float(‘3.3’)+5 -> 8.3

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

Как работают функции приведения типов:

1. При преобразовании строки к числу: функция «читает» строку до первого символа, не позволяющего создать число с плавающей точкой, при этом разделителем целой и дробной частей может быть как точка так и запятая. Если приведение производится к целочисленному типу, то после этого происходит округление. Например:
float('3.6qwerty735') -> 3.6
int('3.6qwerty735') -> 4

2. При преобразовании к булевому типу ложью считается пустая строка либо число 0, все остальное - истина

3. При преобразовании булевого типа к числу истина преобразуется в 1, ложь – в 0. Такое преобразование позволяет использовать сложение и умножение в качестве логических «ИЛИ» и «И» соответственно:
if((5=5)+(6=7), <a>, [b]) – условие истинно, выполнится код «a».

4. При преобразовании булевого типа к строке сначала происходит преобразование к числу:
(5=5)+'qwerty' -> ‘1qwerty’

== Описание синтаксиса ==

Команды разделяются точкой с запятой. Параметры функций разделяются запятыми. Каждая команда (даже цикл while) является функцией, возвращающей некоторое значение. Результатом выполнения составной команды (последовательности функций, разделенных точкой с запятой), является результат выполнения последней функции. Имена переменных, функций, объектов, а также их свойств и методов не чувствительны к регистру.
Константы: константы бывают целочисленными, дробными и строковыми. Значения целочисленных и дробных констант указываются «как есть» (в этом случае разделитель целой и дробной частей – точка), шестнадцатеричные значения начинаются с символа «$» и, если первая цифра – буква, она упреждается цифрой 0, а строковые – в одинарных кавычках. При этом, если внутри строковой константы встречается символ одинарной кавычки он должен быть задвоен, для указания интерпретатору того, что он не является признаком конца константы.
Операции сравнения: >, <, =, ! - Больше, меньше, равно, не равно соответственно.
Логические операции: + (ИЛИ), * (И).
Арифметические операции: +, -, *, /
Операция конкатенации строк: +

=== Функциональность базового объекта ===

'''SET($a, a)''' – присваивает переменной (1-й параметр) значение второго параметра. При отсутствии переменной – создает ее. Имена переменных должны начинаться с символа «$», а следующий символ не должен быть цифрой. Возвращает новое значение переменной. Функция используется только для задания значений переменных. Не допускается использования для задания значений свойств объектов. Для этого используются соответствующие методы этих объектов.

'''IF(a,b,c)''' или '''IF(a,b)''' – Условный оператор. В первом случае возвращает b, если a истинно (не равно нулю или пустой строке), иначе – c. Во втором случае – возвращает a, если оно истинно, иначе – b.

'''WHILE(a, b)''' – Оператор цикла. Выполняет b пока a истинно:
set($i, 10);
set($sum, 0);
while($i>0, set($sum, $sum+$i); set($i, $i-1));
$sum
Результат – 55

'''FOR($a, b, c, d)''' – Оператор цикла. Выполняет d пока $a последовательно присваиваются значения от b до с включительно:
set($sum, 0);
for($i, 1, 10, set($sum, $sum+$i));
$sum
Результат – 55

'''NEW(ClassName, InstanceName)''' – Создает экземпляр класса ClassName, назначает ему имя InstanceName. Возвращает порядковый номер созданного объекта. Доступ к свойствам и методам объектов осуществляется по имени объекта и имени свойства/метода, разделенным точкой. Именем объекта может быть и пустая строка, тогда доступ к его свойствам и методам будет осуществляться без указания имени, и, в случае совпадения имен свойств и/или методов со стандартными или свойствами/методами других объектов, использоваться будут соответствующие свойства/методы объекта, созданного ранее, а также такой объект невозможно уничтожить до окончания выполнения скрипта. Все объекты созданные во время выполнения скрипта уничтожаются автоматически после окончания его выполнения.

'''FREE(InstanceName)''' – Уничтожает объект с именем InstanceName. Возвращает 0. В случае отсутствия объекта с заданным именем вызывает ошибку.

'''ShowObjects''' – Возвращает список созданных объектов – названия классов и имена.

'''ERROR(message)''' – Вызывает ошибку с текстом message.

'''SHOWMESSAGE(message)''' – Отображает диалоговое окно с текстом message, останавливает выполнение скрипта до закрытия окна пользователем.

'''SimpleAskUser(Message)''' – Выводит диалоговое окно с текстом Message и кнопками «Да» и «Нет». Возвращает 1, если пользователь нажал кнопку «Да», иначе – 0.

'''TRY(a)''' – Выполняет a в «защищенном от ошибки» режиме. Если в процессе выполнения a возникает ошибка, возвращает текст ошибки, иначе – 0 (ложь).

'''REM(….)''' – Код в скобках игнорируется (комментарий).

'''EXEC(FileName, Params, Wait, WindowState)''' – Запускает внешнее приложение FileName с параметрами Params. Если Wait истинно – ожидает завершение процесса. Для WindowState доступны следующие числовые значения:
0 - SW_HIDE
1 - SW_SHOWNORMAL (по-умолчанию)
3 - SW_MAXIMIZE
6 - SW_MINIMIZE
Функция возвращает истину если приложение запущено успешно. Иначе – Ложь.
В случае успеха, при параметре Wait – истина кладет в переменную $LastResult код завершения приложения.

'''CASE''' - Оператор множественного выбора. Позволяет выполнить одно из нескольких действий в зависимости от условий. Синтаксис:
<source>
case(
when(условие1, действие1);
when(условие2, действие2);
...
else(действие_по_умолчанию);
);
</source>

Пример использования:
<source>

set($a, 10);
set($b, 50);

showmessage(
case(
when($a < 5, 50);
when($a < 10, 100);
when($a < 250, 200);
else($a*$b);
)
);
</source>

'''AttachDebugger''' - Команда позволяет подключить открытый [[Отладчик_встроенных_скриптов]] к текущему скрипту. Команда AttachDebugger должна быть '''первой командой''' в скрипте. Добавьте её в самое начало скрипта:

<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Как работает:'''
# При выполнении команды AttachDebugger скрипт останавливается.
# Отладчик автоматически подключается к выполняющемуся скрипту.
# Текст скрипта загружается в редактор отладчика.
# Можно ставить точки останова, просматривать переменные и продолжать отладку.

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Если режим отслеживания не включён, команда `AttachDebugger` игнорируется.
* В режиме отслеживания может работать только один отладчик.
* Команда AttachDebugger должна быть первой командой в скрипте.

=== Строковые функции ===

'''UpCase(s)''' – возвращает строку s в верхнем регистре.

'''LCase(s)''' – возвращает строку s в нижнем регистре.

'''Len(s)''' – возвращает количество символов в строке s.

'''Pos(s, substr [,start])''' – возвращает номер первого символа первого включения подстроки substr в строку s, возвращает 0, если включения подстроки отсутствуют. Параметр start - это позиция старта поиска, не обязательный параметр, по умолчанию равен 1. Поиск не чувствителен к регистру.

'''Param(s, i)''' – возвращает i-й элемент строки s, разделенной запятыми на элементы.

'''ParamsCount(s)''' - возвращает количество элементов строки s, разделенной запятыми на элементы.

'''SetParam(s, p, i)''' – заменяет на значение p i-й элемент строки s, разделенной запятыми на элементы.

'''Left(s, i [,full] )''' – возвращает i первых символов строки s. Параметр i, может быть строкой, тогда он считается разделителем и функция, возвращает строку слева от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Mid(s, i, j)''' - возвращает подстроку из s начиная с i символа и длиной j символов

'''Right(s, i [,full])''' – возвращает i последних символов строки s. Параметр i, может быть строкой, тогда он считается разделителем, функция ищет разделитель с конца строки, и возвращает строку справа от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Reverse(s)''' - возвращает строку s задом-наперед. Полезно например для поиска с конца функций Pos().

'''Char(i)''' – возвращает символ с кодом i.

'''Ord(s)''' – возвращает код первого символа строки s.

'''Replace(s, strFind1, strReplace1, [ strFind2, strReplace2, ... ], [caseInsensetive])''' - возвращает строку s, в которой все включения строк strFind заменены строкой strReplace. Параметры поиска и замены всегда должны быть в паре и их может быть несколько. caseInsensetive - неучитывать регистр, не обязательный параметр, по умолчанию включен.

'''RemSpace(s)''' – возвращает сроку s без начальных и конечных запятых и пробелов, а также начальных точек.

'''SumStr(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''с добавлением валюты'''. Необязательные параметры captions - позволяет изменить название валюты, формат строки может зависеть от текущего языка(посмотреть формат можно в "Справочники"-"Статусы"-"32 Валюты", в разделе "Дополнительная информация"). Language - код языка на котором необходимо вывести сумму прописью. По умолчанию если не обязательные параметры опущены, используются региональные настройки в переменных.

'''NumToStrSimple(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''без валюты'''. Параметры идентичны функции SUMSTR.

'''FullNameToShort(Name)''' – Возвращает фамилию и инициалы по полному ФИО Name.

'''MonthName1(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в именительном падеже.

'''MonthName2(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в родительном падеже.

'''StrForXML(s)''' - Подготавливает строку к парсингу как xml: Если находит в строке подстроку "UTF-8" - перекодирует ее из utf-8 в win-1251, убирает начальный знак вопроса, если такой встречается.

'''FixedIntToStr(i, len[, char])''' - Возвращает целое число i дополненное слева символами char (по-умолчанию - "0") до длины len.

'''Translate(format, [param1, param2, ...])''' - Функция перевода строки format в язык пользователя. Строка format может содержать параметры %s, %d - строка и число соответственно.

'''ExtractFileName(FilePath)''' - возвращает имя файла с расширением из полного пути к файлу FilePath.

====Функции перекодировки====
'''DecodeStr(s, charset)''' - Производит перекодировку строки s в кодировку CP1251. Кодировка строки s должна быть заранее известна и может быть :
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866, UNICODE. Имя кодировки следует передавать в точности без лишних символов.

'''EncodeStr(s, charset)''' - Производит перекодировку строки s в кодировку charset. Кодировка строки s должна быть CP1251, возможны следующие варианты перекодировки:
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Имя кодировки следует передавать в точности без лишних символов. UNICODE не работает с версии 2021, в ней строки по умолчанию в кодировке unicode.

Функции EncodeBase64(s), DecodeBase64(s), UrlEncode(s), UTF8Encode(s), UTF8Decode(s), Str2UTF(s) - устарели, используйте EncodeStr, DecodeStr.

====Транслитерация====

'''Translit(s)''' - транслитерация строки русского текста s латиницей

'''UnTranslit(s)''' - транслитерация строки s с латиницы на русский.

==== Экранирование ====

'''QUOTEDSTR(s)''' – квотирует строку s символом «\» (обратный слеш). Возвращает строку s, помещенную между символами одинарной кавычки, при этом все вхождения в строку s символов: «\», «"» и «'» экранируются квотирующим символом, а символы #0, #10 и #13 заменяются на \0, \n и \r соответственно.

'''SQLFloat(f)''' – Приводит число с плавающей точкой к виду, пригодному для SQL-запроса, т.е. к тексту с разделителем дробной части – точка.

'''FormatTextXML(s)''' - квотирует строку s для использования в XML. Производит замены спец. символов для корректности XML-синтаксиса.

'''FormatTextJSON(s)''' - переводит строку в формат JSON, экранирует служебные символы.

'''FormatTextBlob(s)''' - строка s содержит файл, функция перекодирует переданную строку в байты, используется для заполнения полей формата blob.

====Хеширование ====

'''HMACHash256(key, text)''' - создаёт хэш по алгоритму SHA256 для проверки целостности сообщения, key - секретный ключ, text - хэшируемое сообщение

'''MD5Hash(text)''' - создаёт хеш по алгоритму MD5

'''SignatureUrl(url)''' - Подписывает переданный URL. Функция возвратит переданный URL с добавленным в конце параметром, в котором будет записана подпись.

=== Функции работы с датой и временем ===

'''CurrTime''' – возвращает текущее время

'''CurrDate''' – возвращает текущую дату

'''CurrMillisecond''' - Возвращает количество миллисекунд прошедших с начала текущего года. Используется для точного расчета временных интервалов.

'''Today''' - возвращает текущую дату в числовом формате.

'''Day(dt)''' – возвращает день месяца даты dt.

'''Month(dt)''' – возвращает месяц года даты dt.

'''Year(dt)''' – возвращает год даты dt.

'''FirstDayOfMonth(dt)''' – Возвращает первый день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( FirstDayOfMonth( CurrDate() ) );
'''Полужирное начертание'''
'''LastDayOfMonth(dt)''' – Возвращает последний день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( LastDayOfMonth( CurrDate() ) );

'''DaysInMonth(month, year)''' – Возвращает количество дней в указанном месяце.

'''IncDay(dt, [count=1])''' – Возвращает дату, увеличенную на count дней.

'''SQLDate(dt)''' – Пытается конвертировать dt в дату, вернуть в формате «'YYYY-MM-DD'» (с апострофами), если не удается – возвращает «NULL».

'''SQLDateToDate(dt)''' – Переводит дату из SQL-формата в обычный.

'''DAYSBETWEEN(dt1, dt2)''' – Возвращает количество дней между датами dt1 и dt2. В случае ошибки приведения dt1 или dt2 к дате возвращает -1000.

'''TimeBetween(t1, t2)''' - Возвращает количество минут между временем t1 и t2. Если t1 > t2 то будет показано количество минут между t2 и t1. Параметр t может быть как в формате "HH:MM", так и в числовом. Если один из параметров не удалось привести к числовому типу возвращает -1000.

'''WorkDaysBetween(dt1, dt2, [DecreaseFirstDay=0], [DefaultHolidayVarNum=1])''' - Возвращает количество рабочих дней между датами dt1 и dt2. Параметр DecreaseFirstDay уменьшает dt1 на указанное количество дней (по умолчанию 0). В случае ошибки приведения dt1 или dt2 к дате возвращает -1000. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней(по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''TimePeriod(time1, time2)''' - Оформляет временной период. Возвращаемое значение зависит от наличия значения в параметрах. Возможные варианты: "time1 - time2" , "С time1" , "ДО time2".

'''StrDateToFloat(s, [time=false])''' - Переводит строку с датой s в числовой тип. Если параметр time включен, то в строке s должно быть указано время. Дата должна быть в формате "DD.MM.YYYY", а время "HH:NN". Если строку перевести не удалось возвращает 0

'''IsAWorkDay(dt)''' - Когда день dt является рабочим, возвращает true. Если произошла ошибка приведения даты возвращает -1000.

'''IncWorkDay(dt, [count=1],[DefaultHolidayVarNum=1])''' - Прибавляет count рабочих дней к дате dt. Возвращает дату в числовом формате, если произошла ошибка приведения даты возвращает -1000. По умолчанию параметр count равен 1 и не является обязательным. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней (по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''Sleep'''(n) - Задержка выполнения на n миллисекунд.

=== Функции приведения типов ===

'''INT(v)''' – возвращает значение типа “целое”, приводя вариантное значение v к числовому типу, а затем округляя его. В том числе используется как функция округления.

'''FLOAT(v)''' – возвращает значение типа “число”, приводя вариантное значение v к числовому типу, переводя в число цепочку символов до первого нецифрового символа (либо точки или запятой).

'''STR(v)''' – возвращает значение типа “строка”, приводя вариантное значение v к строковому типу.

'''Date(v)''' – возвращает дату, либо пустую строку, если не удается конвертировать v в дату

'''Time(v)''' – возвращает время, либо пустую строку, если не удается конвертировать v во время. Понимает числовое представление времени.

=== Математические функции ===

'''ROUNDUP(f)''' – округляет число f до ближайшего большего по модулю целого числа.

'''ROUNDDN(f)''' – округляет число f до ближайшего меньшего по модулю целого числа.

'''Money(f, CouldBeEmpty, ZeroFill, MakeSpace)''' - Округляет число f, до двух знаков после запятой. CouldBeEmpty - заменить число меньше 0,0001 на пустую строку. ZeroFill - Следить чтобы после запятой было два знака, если будет один, то добавить ноль. MakeSpace - Разделить разряды пробелом.
''Подсказка: для простого округления используется функция int()''

'''Abs(f)''' - возвращает модуль числа f.

'''Mod(x, y)''' - возвращает остаток от деления целочисленного числа x на целочисленное число y.

=== Константы ===

'''Null''' – Возвращает пустое значение.

'''Да''', '''True''', '''Нет''', '''False''' – константы, соответствующие булевым значениям.

=== Прочие функции ===

SetPhoneParams(CountryCode, TownCode) – Устанавливает глобальные настройки кода телефонных кодов страны и города соответственно. По-умолчанию код страны – 7, код города – 495.

PhonesCount(s) – Возвращает количество корректных телефонных номеров, найденных в строке s.

GetPhone(s[, n]) – Возвращает n-й корректный телефонный номер, найденный в строке s. Нумерация начинается с 1.

GetEmail(s) – Возвращает все корректные адреса email, найденный в строке s, разделенные запятыми (т.е. готовыми к передаче в функцию SendEmail).

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

GenEan(ID, Code) – Формирует штрих-код EAN 13 Состоящий из идентификатора типа сущности ID и кода сущности Code, Выравнивает до 13-ти символов, первый – «2», последний – контрольная сума.

CheckEan(s) - Проверяет строку s, что она является кодом EAN13.

SaveToFile(FileName,s, encoding [, append])- Создает текстовый файл по пути, указанному в FileName (если по указанному пути существует файл с указанным именем, он удаляется и создается новый) и производит запись строки s в созданный текстовый файл. encoding - название кодировки, по умолчанию сохраняет в кодировке ANSI. Доступные названия кодировок: KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Если append = true, то производится дописывание данных в файл, а не перезаписывание (не обязательный, по умолчанию выключен).

StrFromFile(FileName) - Читает файл FileName, возвращает в виде строки. При ошибке чтения вызывает ошибку.

DownloadAttachment(code, [savefilepath, tablename='attachment', fieldBlob='file', fieldLDtime='ldtime', fieldUID='uid']) - Функция выкачивает аттачмент из базы, по внутреннему коду - Code, всегда возвращает содержимое файла в виде строки, а также может сохранить файл по указанному пути в параметре savefilepath. По умолчанию, функция настроена на таблицу attachment. Code - внутренний код вложения, tablename - название таблицы, fieldBlob - название поля с содержимым файла, fieldLDtime - название поля с временем последнего изменения строки (для работы кэша). Функция использует кэш и умеет выкачивать файлы зауженные на внешние серверы (http, ftp,sftp, measoft). Для выкачивания с сервера measoft обязательно необходимо указывать параметр fieldUID.

DeleteFile(FileName) - Удаляет файл FileName с диска, возвращает истину, если операция прошла успешно и ложь - в противном случае.

HTTPPOST(host, PostParams, Proxy, ContentType, HTTPUser, HTTPPass, Method, CustomHeader, Reconnects) - Отправляет HTTP запрос по адресу host с данными PostParams. Proxy - объект Proxy, задающий прокси-сервер (по-умолчанию - пусто - не использовать прокси). ContentType - Заголовок ContentType. По-умолчанию - "application/x-www-form-urlencoded; Charset=UTF-8". HTTPUser и HTTPPass - данные для http-авторизации на сервере. Method - метод отправки запроса, по-умолчанию - "POST". CustomHeader - Дополнительные заголовки HTTP запроса, передается в виде списка параметров через запятую и всегда образуют пару: 1 параметр - название заголовка, 2 параметр - значение. Если значение содержит запятую то его нужно экранировать в двойные кавычки. Reconnects - Количество попыток подключения (по-умолчанию - 2), если больше 100 - это таймаут единственной попытки подключения в миллисекундах.
Функция возвращает ответ сервера. 
''Обратите внимание:'' Для имитации отправки данных html-формы методом POST может понадобиться перед передаваемыми параметрами добавить "Data=".

FTPPUT(host, User, Pass, FileName[, Active]) - Отправляет файл на FTP/SFTP-сервер. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

FTPGET(host, User, Pass, SourceFileName, DestFileName[, Active]) - Загружает файл SourceFileName с FTP/SFTP-сервера, сохраняет его в файл DestFileName. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

GetTempDir - Возвращает путь к временной папке.

ApplicationDir - Возвращает путь к файлу программы.

Interpretate(script) - Интерпретирует скрипт указанный в script. Выполнение происходит в текущем инстансе.

LastHttpError - Выводит последний запрос выполненный с ошибкой в функции HttpPost. Содержит подробную информацию по запросу и ответу.

LastHttpResponse - Выводит последний запрос и ответ от сервера после выполнения Http-запроса в функции HttpPost.

== Объект TExcel ==

Предназначен для доступа к данным документов MS Excel. Требует установленного приложения MS Excel. Для работы без установленного MS Excel предусмотрен объект TDirectExcel.

'''''Ввод данных'''''

LoadFromDB(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Если Headered истинно (по-умолчанию), таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Если TranslateHeader истинно, то заголовки таблицы будут автоматически переведены.

MyDB.Open('select * from kurier');
xl.LoadFromDB(MyDB.Self);
xl.DoNotDestroy(true);
xl.SetVisible(true);

Post2Sheet(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) - Почти полный аналог LoadFromDB. В отличии от LoadFromDB если есть открытый файл, выгрузка данных будет выполнена прямо в него.

OpenFile(aFileName) – Выполняет функции SetFileName и Open.

FileName – Возвращает имя текущего файла.

SetFileName(aFileName) – Задает значение свойства FileName.

Open - Открывает файл с именем, заданным свойством FileName. Если имя файла не задано - создает чистую книгу.

Close – Закрывает текущий файл.

'''''Ячейки'''''

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

Cell(x, y, text) – Возвращает значение ячейки, заданной координатами x, y. Необязательный булевый параметр text, в случае истинности, указывает на необходимость возврата данных с учетом формата ячейки, т.е. то, что пользователь видит на экране. Обратите внимание, что если в ячейке число, и ширина столбца не достаточна для отображения, Excel выводит "#####", что и будет возвращено программе, если text=ИСТИНА. Поэтому перед таким использованием рекомендуется выполнить функцию AutoFit.

SetCell(x, y, v[, x2, y2]) – Устанавливает значение ячейки, заданной координатами x и y, в значение v. Если заданы параметры x2, y2 - объединяет (merge) диапазон ячеек заданных координатами, устанавливает значение объединенной ячейки.

'''''Строки'''''

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

RowAutoFit([y1, y2]) - Устанавливает автоматическую высоту строк. Аргументы y1 и y2 необязательны и если не указаны, то процедура будет выполнена для всей страницы, в ином случае только для строк от y1 до y2.

SetRowHeight(r, h[, cnt]) – Устанавливает высоту cnt строк (по-умолчанию 1) начиная со строки r в h пикселей.

GetRowHeight(r) – Возвращает высоту строки r в пикселях.

RowInsert(i[, count]) - Вставляет count (по-умолчанию - 1) строк НАД строкой с номером i.

RowDelete(i[, count]) - Удаляет count (по-умолчанию - 1) строк начиная с номера i.

'''''Столбцы'''''

ColCount - Возвращает количество столбцов в листе.

AutoFit – Устанавливает автоматическую ширину столбцов.

ColumnDelete(i[, count]) - Удаляет count (по-умолчанию - 1) столбцов начиная с номера i.

SetColWidth (c, w) – Устанавливает ширину столбца c в w пикселей.

GetColWidth (c) – Возвращает ширину столбца c в пикселях.

'''''Листы'''''

SetSheet(No) – Устанавливает номер текущего листа. Если лист с таким номером не существует - он будет создан (и все листы до него). Нумерация начинается с 1.

SetSheetName(Name) - Устанавливает название текущего листа.

SheetsCount – Возвращает количество листов в книге.

CopySheetAfter([SheetFrom[, SheetAfter]]) - Копирует лист SheetFrom (по-умолчанию - текущий), создавая новый лист после листа SheetAfter (по-умолчанию - совпадает с копируемым).

SheetDelete(i) - Удаляет лист с номером i.

'''''Форматирование'''''

Align(x1, y1, x2, y2 [,HAlign, VAlign]) - Устанавливает выравнивание данных в указанном диапазоне. HAlign - горизонтальное выравнивание (0 – прижато влево , 1 – по центру , 2 – прижато вправо), VAlign - Вертикальное выравнивание (0 – прижато к верху , 1 – по центру , 2 – прижато к низу).

WrapText(x1, y1, x2, y2, value) – Устанавливает перенос текста прямоугольника в значение value. Если координаты опущены, или 0 – устанавливает границы всей используемой области. Для Value значение по-умолчанию - true.

NumberFormat(x1, y1, x2, y2, Format) - Устанавливает формат вывода чисел в указанном диапазоне ячеек. Например, если Format='0.00' - числа будут выводиться c обязательными 2 знаками после десятичного разделителя.

SetBorders(x1, y1, x2, y2) – Устанавливает границы прямоугольника. Если координаты опущены, или 0 – устанавливает границы всей используемой области.

SetFont(Font[, x1, y1[, x2, y2]]) - Устанавливает шрифт Font для ячеек диапазона. Можно указать координаты только одной ячейки, можно - вообще не указать, тогда будет использован последний выделенный диапазон. Шрифт задается как обычно: 'Arial, 16, T, T, T', порядок параметров: Имя шрифта, размер, жирное начертание, курсивное начертание, одиночное подчеркивание. Если параметры не заданы, то у текущего шрифта они меняться не будут. Примеры: SetFont('Arial, 10, T, F, F', 1,1) - в ячейке A1 будет установлен шрифт Arial жирным начертанием (не курсив и без подчеркивания). SetFont(', , , T, F', 2,1) - в ячейке B1 будет поменяется только начертание курсив и будет отменено подчеркивание (если оно было).

SaveValuesOnly - убирает формулы на текущей странице и оставляет лишь их результативные статичные значения.

'''''Цвета'''''

SetRowFontColor(Row,Color) - Устанавливает цвет шрифта в строке Row. Color - целое значение (RGB)

SetRowColor(Row,Color) - Устанавливает цвет фона в строке Row. Color - целое значение (RGB)

SetColumnFontColor(Col,Color) - Устанавливает цвет шрифта в столбце Col. Color - целое значение (RGB)

SetColumnColor(Col,Color) - Устанавливает цвет фона в столбце Col. Color - целое значение (RGB)

SetCellFontColor(Row,Col,Color) - Устанавливает цвет шрифта в ячейке с координатами [Row,Col]. Color - целое значение, равное номеру цвета в палитре (ColorIndex,не RGB)

SetCellColor(Row,Col,Color) - Устанавливает цвет фона в ячейке с координатами [Row,Col]. Color - целое значение (RGB)

GetRowFontColor(Row)- Возвращает RGB значение цвета шрифта строки Row

GetRowColor(Row)- Возвращает RGB значение цвета фона строки Row

GetColumnFontColor(Col)- Возвращает RGB значение цвета шрифта столбца Col

GetColumnColor(Col)- Возвращает RGB значение цвета фона столбца Col

GetCellFontColor(Row,Col) - Возвращает номер цвета шрифта в палитре (ColorIndex) в ячейке с координатами [Row,Col]

GetCellColor(Row,Col) - Возвращает RGB значение цвета фона в ячейке с координатами [Row,Col]

'''''Копи-паст'''''

Copy(x1, y1, x2, y2) - Копирует в буфер экселя

Cut(x1, y1, x2, y2) - Вырезает в буфер экселя

Paste(x1, y1) - Вставляет из буфера экселя. Команды copy-paste неразрывны, если что нибудь сделать в промежутке между ними, например вставить значение в ячейку, то копирование сброситься. (Последовательность использования: copy - paste, cut - paste)

PasteStyle(x1, x2, y1, y2) - Вставляет только оформление из буфера экселя (Последовательность использования: Copy - PasteStyle)

'''''Изображения'''''

InsertPicture(TPicture, [x=1, y=1, DispX=0, DispY=0, width=0, height=0]) - Функция вставляет рисунок на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки, width, height (не работает для DirectExcel) - ширина и высота области рисунка в пойнтах-единицах Excel

InsertFirmLogo(FirmCode, [x=1, y=1, DispX=0, DispY=0]) - Функция вставляет логотип фирмы с кодом FirmCode на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки.

'''''Вывод'''''

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки. Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SheetFitPageWidth - устанавливает режим масштабирования печати, чтобы печатная форма помещалась в ширину на один лист.

SetOrientation(value) - Устанавливает ориентацию страницы. True (по-умолчанию) - альбомная (ландшафтная), Ложь - портретная.

PrintOut([copies]) - Печатает текущий лист на принтере по умолчанию. Параметр copies - количество копий, по умолчанию равен 1.

Save(filename) - Сохраняет в файл filename. Если файл существует, в основной системе он будет перезаписан, в других проектах - вызовет ошибку "Файл уже существует".

SetVisible(b) – Устанавливает видимость приложения Excel для пользователя. По-умолчанию – false (не видимо).

DoNotDestroy(b) – При уничтожении объекта TExcel (а он уничтожается, как и все остальные объекты автоматически при завершении выполнения скрипта), приложение Excel уничтожается вместе с ним. DoNotDestroy(true) отключает уничтожение приложения.

'''''Пример использования'''''

new('TExcel', 'myxl');
myxl.OpenFile('c:\asdf.xlsx');
set($sum, 0);
while (myxl.EOF=0,
set($sum, $sum+int(myxl.c));
myxl.next );
$sum

''Возвращает сумму всех числовых данных столбца C файла 'c:\asdf.xlsx'''

== Объект TDirectExcel ==
Объект позволяет работать с файлами Excel напрямую, без установленного пакета MsOffice. Применяется в сервисах и при отсутствии экселя. Он максимально совместим с объектом TExcel, однако некоторые методы могут быть не реализованы.

== Объект TCSVFile ==
Предназначен для доступа к данным документов CSV. Разделителем столбцов является символ точка с запятой ;

Функции:

FileName – Возвращает имя текущего файла.

OpenFile(FileName) – Открывает файл FileName.

LoadFromDB(DB[, Headered=false]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO.

LoadFromText(s) - Загружает таблицу из строки s.

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки.

SaveToFile(Filename) - Сохраняет в файл с именем filename.

== Объект TADO ==

Предназначен для доступа к базам данных.

Функции:
{| class="wikitable"
!Функция
!Описание
|-
|Connect(ConnectionString)
|Подключает к источнику данных. ConnectionString – Строка подключения ADO.
|-
|ConnectMySQL(DBServer, DBPort, DBUser, DBPass, DBName)
|Подключает к базе данных MySQL.
|-
|Open(Query)
|Открывает набор данных выполнив запрос Query.
|-
|FieldByNo(i)
|Возвращает значение поля с номером i. Нумерация полей – с нуля.
|-
|FieldName(i)
|Возвращает имя поля с номером i.
|-
|FieldCount
|Возвращает количество полей.
|-
|RecordCount
|Возвращает количество записей.
|-
|RecNo
|Возвращает номер текущей записи. ''ВНИМАНИЕ! В зависимости от способа подключения к БД нумерация может начинаться как с 0 так и с 1!''
|-
|EOF
|Возвращает признак достижения конца набора данных. Становится истиной когда выполняется команда Next на последней записи.
|-
|Next
|Переход на следующую запись набора.
|-
|First
|Переход на первую запись набора.
|-
|Last
|Переход на последнюю запись набора.
|-
|FieldByName(FieldName)
|Возвращает значение поля по имени. Также возможно указание имени поля как свойства объекта.
|-
|Field(Table, ID, FieldName)
|Возвращает значение поля FieldName записи с кодом ID таблицы Table. Набор данных, если он открыт, при этом не закрывается. Первичный ключ таблицы должен называться «code». Гарантированно работает только с MYSQL!!!
|-
|GetSQLValue(Query)
|Выполняет SQL-запрос. Текст запроса должен начинаться с первого символа строки (перед запросом не должно быть пробелов, переносов строк, комментариев и т.д.). Если запрос Insert – возвращает ID вставленной записи. Если запрос – Update, Delete, Replace, Set, Start, Commit, Rollback – возвращает количество измененных записей (RowsAffected), иначе – Select – значение первого поля первой строки результата как текст.
|-
|FillText(s)
|Возвращает строку s с замененными названиями полей между знаками процента на соответствующие значения текущей записи. Так же в строке возможно использование интерпретируемого кода, заключенного между тегами "<?>" и ">". При интерпретации система сначала производит замену полей с процентами на значения, потом интерпретирует код. ''Внимание! Функция не создает отельный контекст интерпретатора, а использует существующий, в нем доступны все объекты и переменные, вызывающего скрипта.'' Дополнительно автоматически создается объект TSelfADO, подключенный к той же БД, что и контекст, вызвавший функцию, с пустым именем, а так же с именем "dataset".
|-
|Query(Query)
|Синоним GetSQLValue.
|-
|Close
|Закрывает набор данных.
|-
|Self
|Возвращает указатель на подключение к БД для использования в других объектах.
|-
|ParseForIn([FieldName='code'])
|Возвращает через запятую значения всех строк в указанном столбце. По умолчанию, используется столбец с именем code.
|-
|GetSQL
|Для отладки. Возвращает последний SQL запрос переданный в методы Open, Query, GetSQLValue
|-
|ExportExcel
|Для отладки. Выгружает в эксель содержимое датасета. Можно использовать в незнакомом окружении для понимания передаваемых полей в : шаблонах, печатных формах и т.д. Аналог команды %echo% в шаблонах, на случай если она не сработает.
|-
|OnGetText
|Функция подменяет текстовый вывод значения поля при выгрузке в эксель. Первый параметр это имя поля, которое надо подменить. Второй параметр это то что необходимо вывести. Работает только с текстовыми полями.
'''''Пример использования'''''
DB.OnGetText('Зона', IF((DB.FieldByName('-Lat') ! 0) * (DB.FieldByName('-Lon') ! 0),
GetPolygonByLatLon(DB.FieldByName('-Lat'), DB.FieldByName('-Lon'), 'TYPE = 1 AND IFNULL(zone, 0) > 0 AND PRICE = ' + DB.FieldByName('-price'), 'zone')
,
''
));
|}

Пример использования – см. TSelfADO

== Объект TSelfADO ==

Наследник объекта TADO. Служит для подключения к «родной» для программы, в которой выполняется скрипт, базе данных. Обладает всеми свойствами и методами объекта TADO, кроме Connect. Иногда автоматически создается системой для обеспечения простого доступа к базе данных, а также иногда создается системой с уже открытым набором данных для передачи обрабатываемого системой набора данных в скрипт. В этом случае для скрипта недоступны функции Open и Close.

Пример использования:

rem('Копируем данные из "родной" базы данных в базу MSSQL.');
new('TSelfADO', 'MyDB');
new('TADO', 'MSSQL');
MSSQL.Connect('Provider=SQLOLEDB.1;Password=myPassword;Persist Security Info=True;User ID=myUsername;Initial Catalog=myDataBase;Data Source=myServerAddress');
MyDB.Open('select code, name, passport from kurier where code>'+Int(MSSQL.Query('select max(code) from kurier'))+' order by code');
While(MyDB.EOF=0,
MSSQL.Query('insert kurier (code, name, passport) VALUES ('+MyDB.Code+', '+QuotedStr(MyDB.Name)+', '+QuotedStr(MyDB.Passport)+')');
MyDB.Next;
);

== Объект TPrinter ==

Предназначен для доступа к принтерам.

Функции:

BeginDoc – Начинает новый документ.

EndDoc – Закрывает документ

PageHeight – Возвращает высоту страницы в пикселях

PageWidth – Возвращает ширину страницы в пикселях

PageNumber – Возвращает номер текущей страницы документа

Orientation – Возвращает текущую ориентацию страницы (0 – портретная, 1 – ландшафтная)

Printing – Возвращает истину если документ открыт

SetOrientation(Orientation) – Устанавливает ориентацию страницы. При необходимости начинает новый документ, новую страницу.

ShowDialog – Показывает пользовательский диалог печати. Возвращает истину, если пользователь нажал "OK".

NewPage – Начинает новую страницу

Canvas – Предоставляет доступ к объекту TCanvas, связанному с принтером.

PrinterNames – Возвращает список принтеров, установленных в системе, разделенный переносами строк

PrintersCount – Возвращает количество установленных в системе принтеров

SetPrinter(Printer) – Устанавливает текущий принтер. Если передана строка – ищет принтер по названию, иначе – по номеру. Нумерация начинается с 0.

PrintTable(Y, Table) – Выводит на печать таблицу Table типа TTable, начиная с координаты Y. При необходимости таблица печатается на нескольких страницах. Возвращает координату Y конца таблицы.

GetDefaultPrinter - Возвращает имя текущего активного принтера.

SetDefaultPrinter(Printer) – Запоминает предыдущий активный принтер и устанавливает новый текущий принтер. Printer - имя принтера. При необходимости нескольких последовательных вызовов SetDefaultPrinter рекомендуется между вызовами использовать RestoreDefaultPrinter.

RestoreDefaultPrinter - Устанавливает активным принтер, который был текущим перед последним вызовом SetDefaultPrinter.

== Объект TCanvas ==

Предоставляет доступ к холсту объекта для прорисовки изображения.

Функции:

DPIX – Возвращает разрешение холста по горизонтали в точках на дюйм

DPIY – Возвращает разрешение холста по вертикали в точках на дюйм

TextOut(x, y, s[, x1, y1, x2, y2]) – Выводит строку s начиная с точки с координатами x и y. Если указаны параметры x1, y1, x2, y2 – то выводимый текст ограничивается заданным прямоугольником.

TextOutEx(x1, y1, x2, y2, Alignment, Font, s, Indent) – Выводит строку s в прямоугольнике с координатами x1, y1, x2, y2. По горизонтали строка выравнивается в соответствии с Alignment (0 – прижато влево, 1 – вправо, 2 – по центру), по вертикали выравнивается по центру. Используя шрифт Font (см описание ниже). Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату X фактического окончания текста (правой стороны – если строка прижата влево, и левой – в остальных случаях)

MLTextOut(x1, y1, x2, y2, Alignment, VAlignment, Font, s, Heigth, Indent) – Выводит многострочный текст s в прямоугольнике с координатами x1, y1, x2, y2 с переносом по словам. По горизонтали строки выравниваются в соответствии с Alignment, по вертикали – в соответствии с VAlignment (0 – прижато вверх, 1 – по центру, 2 – прижато вниз). Используя шрифт Font (см описание ниже). Heigth – высота строки. Если опущено или равно нулю – высота определяется автоматически в соответствии с выбранным шрифтом. Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату Y фактического окончания текста (нижней границы последней строки текста. ''ВНИМАНИЕ! Функция использует координаты прямоугольника для позиционирования текста, однако она не ограничивает его верхней и нижней границами этого прямоугольника!''

DrawPic(x1, y1, x2, y2, Pic, Style, Alignment, Mode) – Прорисовывает изображение Pic (ссылка на изображение TPicture.Self) в прямоугольник заданный координатами x1-y2. Style – стиль масштабирования. 0 – растянуть изображение до границ прямоугольника не сохраняя пропорции, 1 – вписать изображение в прямоугольник сохраняя пропорции – вероятно, останутся поля по вертикали или горизонтали, 2 – вписать сохраняя пропорции, обрезав при необходимости изображение по вертикали или горизонтали. Alignment – выравнивание по горизонтали. Работает только в случае если style=1 и при растягивании изображения получились вертикальные поля. 0 – разместить по центру, 1 – прижать влево, 2 – прижать вправо. Функция возвращает координату X правой стороны изображения кроме случая, когда Style=1 и Alignment=2 – в этом случае возвращается координата левой стороны изображения. Mode - способ наложения изображения. 0 (по-умолчанию) - копирование как есть. 1 - Наложение операцией AND (применяется для получения эффекта прозрачности изображения), 2 - наложение операцией XOR (Применяется для возможности повторной операцией убрать изображение), 3 - Наложение операцией OR.

FillRect(x1, y1, x2, y2) – Рисует прямоугольник '''без границ''' и закрашивает цветом BrashColor

Rect(x1, y1, x2, y2) – Рисует прямоугольник '''c границами''', задаваемыми текущим пером, и закрашивает цветом BrashColor

SetFont(Font) – Устанавливает шрифт по-умолчанию.

SetPen(Width, Color) - Устанавливает параметры "ручки" - толщину и цвет. Если любой параметр опустить, соответствующее значение не будет изменено.

SetBrush(Color, Style) - Устанавливает параметры заливки - цвет и стиль. Если любой параметр опустить, соответствующее значение не будет изменено. Стили заливки: 0 - сплошная, 1 - отсутствует (прозрачная), 2-7 - различные виды штриховки (горизонтальные, вертикальные, в клеточку и т.д.).

TextHeight(s) – Возвращает высоту текста s в пикселях без учета многострочности, с учетом текущего шрифта.

TextWidth(s) – Возвращает ширину текста s в пикселях без учета многострочности, с учетом текущего шрифта.

Использование шрифта (Font): У объекта TCanvas есть «глобальные» установки шрифта. Однако для некоторых функций возможно указание шрифта, отличающегося от глобального. Параметры шрифта – это текстовая строка, состоящая из 6-ти параметров, разделенных запятыми: Название, размер, жирный, курсив, подчеркнутый, цвет. Например:

'Times New Roman, 8, Y, N, N, 255'

Любой параметр можно опустить, и тогда вместо него будет использовано значение по-умолчанию: шрифт: arial, размер – 10, не жирный, не курсив, не подчеркнутый, цвет – черный. Например: ', 7' – указывает, что по-умолчанию нужно взять все параметры кроме размера шрифта. Также можно вместо всей строки указать тире ('-') или пустую строку, и шрифт будет использоваться «глобальный».

Объект можно создать отдельно, не создавая объект TPrinter. В таком случае объект создастся как ссылка на текущий холст принтера (принтер должен быть запущен и начат новый документ). Такой подход используется в доп. возможности PrintCustomSticker

== Объект TPicture ==

Предоставляет функции для работы с графическими изображениями форматов BMP, GIF, JPEG и PNG, а также для формирования штрих-кодов. Обратите внимание, прозрачность изображений не поддерживается, однако в методе TCanvas.DrawPic есть параметр Mode, призванный создавать эффект прозрачности.

Функции:

LoadFromFile(FileName) – Загружает изображение из файла FileName. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromDB(DB, Query) – Загружает изображение из базы данных. DB – ссылка на подключение к базе данных TADO.Self, Query – текст запроса. Запрос должен вернуть в первом поле первой строки BLOB-поле с изображением, все остальные данные возвращаемые запросом игнорируются. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromStr($s) – Загружает изображение из строки $s. Возвращает истину, если операция прошла успешно, иначе – ложь.

CreateBar(Width, Height, BarCode, Textless, Type) – Формирует штрих-код шириной Width и высотой Height с типом кодирования Type. BarCode – текст штрих-кода. Булево значение Textless указывает, что в штрих-коде не должно быть человеко-читаемых символов если истинно. Type указывает тип кодирования: 0 (по-умолчанию) CODE128, 1 - EAN-13, 2 - Interleaved 2-5, 3-DataMatrix, 4-QRCode.
Штрихкод должен быть: Для EAN-13 цифровым 12 или 13 символов (13-й, контрольная сумма рассчитывается автоматически), для CODE128 - должен иметь состоять из допустимого для этого кодирования набора символов. Для Interleaved - должен состоять из четного числа цифр, контрольная сумма автоматически не рассчитывается. Если для Interleaved кода указано значение из 14-ти знаков, подпись цифр выводится в формате Почты России.
Внимание! Для кодов EAN-13 и Interleaved ширина штрих-кода Width не является точным значением получаемого на выходе изображения. Ширина изображения рассчитывается как максимальное кратное минимально возможной ширине, но не меньше минимально возможной. Конечную ширину можно получить в соответствующем свойстве объекта. Для кода CODE128 штрих-код на выходе может оказаться пустым, если указанной ширины штрих-кода не достаточно для его формирования.
Для кода DataMatrix можно установить режим для печати скрытых символов с кодами 29(GS) и 232(FCN1), которые требуются для формирования Честного Знака. Для этого необходимо в начале строки указать символ "[" и все разделители 01, 21, 91, 92 так же экранировать этими скобками. Должно получиться [01]02900002317701[21]k3LInNbH_oG0Q[91]EE06[92]YXiyKfiHjE4YE8b+YVMC1O5r8VtpplA3AwcCqrcG9Dk= . При формировании кода, включится режим формирования штрих-кода DataMatrix GS1, в начале будет добавлен символ с кодом 232 (FCN1), а потом будут добавлены разделители с кодом 29 (GS)
Функция возвращает 1 в случае успеха, или текст ошибки, если такая произошла.

SetSize(Width, Height) - Устанавливает размер изображения.

AsString([ImageFormat]) - Возвращает изображение в виде строки с двоичными данными. ImageFormat принимает значения 1 - Bitmap (по-умолчанию), 2 - jpeg, 3 - png, 4 - gif.

Width – Возвращает ширину изображения.

Height – Возвращает высоту изображения.

Rotate(Angle) – Поворачивает изображение по часовой стрелке на угол Angle. Угол указывается в градусах и может принимать любые значения.

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

Canvas - ссылка на объект TCanvas холста изображения.

== Объект TTable ==

Предоставляет функции для работы с таблицами. Удобен для печати таблицы на принтере. Алгоритм таков: Загружаем датасет в таблицу, настраиваем ее (шрифты, штрих-коды и т.д.), потом выводим на принтер функцией TPrinter.PrintTable.

Функции:

LoadFromDB(DB) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Заголовок – это первая строка таблицы.

Cell(С, R) – Возвращает значение ячейки таблицы с координатами (C, R). Нумерация строк и столбцов начинается с 1.

SetCell(С, R, Value) – Устанавливает значение ячейки таблицы с координатами (C, R) в Value. Нумерация строк и столбцов начинается с 1.

RowCount – Возвращает количество строк в таблице.

ColCount – Возвращает количество столбцов в таблице.

SetTitleFont(Font) – Задает шрифт заголовка таблицы (первой строки).

SetFont(Font) – Задает шрифт всей таблицы кроме заголовка.

SetColFont(C, Font) - Устанавливает шрифт столбца C.

SetIndent(Indent) – Задает отступ от границы ячейки до текста в процентах от ширины страницы. По-умолчанию значение 0.3

SetWidth(С, Width) – Задает значение ширины столбца C в процентах от ширины страницы.

SetMinRowHeght (Heght) – Задает значение минимальной высоты строки в пикселях.

SetBarCode(Col, Type) - Указывает, что данные из столбца Col должны печататься в виде штрих-кода. Тип штрих-кода - Type. Значение '''"1" - EAN13'''. Для кода EAN13 первая строка данных в ячейке должна иметь вид "тип штрих-кода, номер", например "7, 123" (без кавычек, конечно). В этом случае система сформирует штрих-код: "2700000001233". Первая цифра - всегда 2, далее - указанный тип штрих-кода, нули, чтобы получилось 13 символов, номер, указанный в таблице, и один символ - контрольная сумма. Значение '''"2" - CODE128''' (с версии 734). Данные из первой строки ячейки таблицы печатаются в штрих-коде "как есть". Для всех видов штрих-кода (с версии 734) последующие строки печатаются под штрих-кодом в виде текста.

SetMultiHeader(Active) - Включает печать заголовка при переносе таблицы на несколько страниц. По умолчанию отключено.

SetCustomHeader(script) - Включает печать пользовательского заголовка. Script - это код интерпретатора, который должен печатать заголовок на канву. Печать таблицы может происходить на нескольких листах, по этому скрипт будет вызван для каждого листа. При использовании этого метода, автоматически инициализируются переменные: $TablePageNo - номер страницы, нумерация начинается с нуля; $TableY - координата по оси Y, от которой рисуется заголовок. Чтобы таблица была под заголовком необходимо значение переменной $TableY увеличить на высоту заголовка.

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

Пример:
<?>
NEW('TPrinter', 'Prn');
If(prn.ShowDialog,
NEW('TTable', 'Tbl');
NEW('TSelfADO', 'MyDB');
MyDB.Open('SELECT concat("7", ", ", a.code, "\r\n", a.client_id, "\r\n", a.zakaz, "-", a.number) as "Штрих-код", a.target AS "Заказик", address, phone, vlog, poruch FROM address a order by code desc limit 10');
Tbl.LoadFromDB(MyDB.Self);
Tbl.SetBarcode(1, 1);
Tbl.SetCustomHeader(
if($TablePageNo>0,
Prn.Canvas.TextOut(Prn.Canvas.DPIX*0.1, $TableY, 'Продолжение таблицы');
set($TableY, $TableY + Prn.Canvas.TextHeight('H'));
,0)
);
Prn.BeginDoc;
Prn.PrintTable(0, Tbl.Self);
Prn.EndDoc
, );

== Объект TBaseUtils ==

Предоставляет функции, базирующиеся на БД системы «MEASOFT». По-умолчанию, при создании подключается к основной базе данных модуля, в котором выполняется скрипт, если такая определена контекстом, однако это можно изменить, см SetConnection.

Функции:

'''MakeAddress(s[,town])''' – возвращает значение, полученное путем преобразований адреса s для приведения его к внутреннему формату программы. В процессе преобразования до нескольких раз происходит замена буквосочетаний по таблице замены (ее редактирование доступно по нажатию кнопки «Автозамена» в интерфейсе импорта БД из Excel системы (см. Руководство пользователя)), поиск улиц по базе КЛАДР с точностью до одного знака, и некоторые другие операции, нацеленные на исправление ошибок в написании адреса.

С версии программы 2008.0.0.615, при вызове функции в формулах загрузки реестра, в первую очередь происходит проверка строки s на условия:
* в строке s записано число;
* строка s начинается с "ПВЗ ".
Если одно из этих условий выполняется, то функция пытается установить пункт самовывоза - т.е она сама в загружаемой карточке корреспонденции укажет: адрес ПВЗ, город ПВЗ и установит галку самовывоз. Правила поиска ПВЗ:
* Если s число - считаем его внутренним кодом филиала;
* Если s начинается с "ПВЗ " - Например в адресе передана строка "ПВЗ На Ленинском проспекте", то искать будем филиал с названием "На Ленинском проспекте" который подчиненный, активный, с галкой ПВЗ и в городе town. Если город не указан, то ищем филиал во всех городах, и считаем его найденным если найдем только один филиал.
* Если филиалы найти не удалось, функция makeaddress работает как обычно и выполняет преобразование адреса.

Если адрес не содержит русских букв, только латиница, и курьерская служба находится в одной из стран Россия, Белоруссия, Казахстан или Украина, и город-получатель (второй параметр, town) находится так же в одной из этих стран, функция автоматически делает транслитерацию адреса на русский язык.

''SetConnection(DB) – Подключает объект к базе данных DB, где DB – ссылка на объект TADO.Self.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

''SetTown(Town) – Устанавливает код текущего города (используется в некоторых функциях объекта) в значение Town. По-умолчанию текущий город – 1.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

'''SetIndexLength(Length)''' – Устанавливает длину почтового индекса. По-умолчанию – 6.

'''GetIndex(Address)''' – Возвращает почтовый индекс из адреса.

'''GetStreet(Address)''' - Возвращает улицу до первой запятой.

'''GetHome(Address)''' - Возвращает номер дома до второй запятой, но не более пяти символов.

'''GetKurierByStation(station, Mass, Cash, Date_Putn)'''

'''TownByIndex(Index[, PriorityName][, PriorityCountry])''' – Возвращает код города по индексу. В случае ошибки поиска – код текущего города. Если нашлось несколько населенных пунктов, и указано приоритетное название - выбирается населенный пункт, название которого начинается с PriorityName (если есть).

'''TownByName(Name[,NotNeedCL=False, City=0])''' – Возвращает код города по имени. В случае ошибки поиска – возвратит код текущего города. Если параметр NotNeedCL (параметр не обязательный) установить в TRUE, тогда функция возвратит 0, если город не удалось найти. Параметр City (код региона) позволяет ограничить поиск одной областью (не обязательный, по умолчанию не используется).

'''FillClientInfo(Excel, client, Sheet, Row, Col)''' – Выводит в эксель информацию о клиенте с кодом client на лист sheet начиная со строки row и столбца col.

'''SavePrintFormToFile(FormType, FormNumber)''' - Сохраняет на диске файл печатной формы и возвращает путь к нему

'''CreateTrans(Address[, Store][, Operator][,Correction])''' - Формирует запись для печати кассового чека для корреспонденции с кодом Address, для выбора кассового аппарата используется код склада Store. Если Store не указано - при исполнении в среде клиентского модуля системы использует склад, указанный пользователем в окне [[Настройка параметров рабочего места|"Настройка" - "Параметры"]], в остальных модулях - код текущего склада из [[Настройка глобальных параметров|переменной]] "CL" ("Текущий филиал"). Поле Operator позволяет указать кассира (передается код справочника сотрудников). Если не указан, в основной системе будет использован код авторизованного пользователя, в других модулях - 1.
Поле Correction позволяет указать данные для корректировочного чека, используется в системе Штрих-М. По умолчанию пустая строка. Возвращает идентификаторы записей чеков. Может вернуть пустую строку, если чек создавать не понадобилось, один или несколько кодов через запятую, если создано несколько чеков. В случае ошибки вызывает ошибку, поэтому рекомендуется использовать с функцией Try.

'''CreateReturnTrans(Address)''' - формирует запись для печати чека возврата для корреспонденции с кодом Address. Чек возврата печатается на полную сумму и с теми же атрибутами, что и чек продажи. Возвращает идентификатор записи чека возврата. В случае ошибки вызывает ошибку, поэтому, как и с CreateTrans, рекомендуется использовать с функцией Try.

'''CalcTownDeliveryDays(Source, Mode, TownTo, TownFrom)''' - возвращает количество дней необходимых на доставку отправления, только для межгорода. Source - код клиента, Mode - режим срочности, TownFrom - код города отправителя, TownTo - код города получателя.

'''CalcDeliveryDate(Source, Mode, TownTo, TownFrom, Date_Beg, Time_beg)''' - Возвращает планируемую дату доставки с учетом сроков доставки. Работает при городской и междугородней доставке. Для межгорода сроки доставки берутся из зон. Для городской доставки, из дополнительных параметров статуса (17 статус, 1 параметр в доп. информации) Если рассчитать дату планируемой доставки не удалось, возвращает пустую строку. Параметры: Source - код клиента, Mode - режим срочности, TownTo - город получатель, TownFrom - город отправитель, date_beg - дата заказа (может быть передана строкой в формате DD.MM.YYYY или в числовом), time_beg - время заказа.

'''GenSpecialSMA(DirectExcel, Code)''' - функция для генерации отчета о доставке по акту передачи денег. Первый параметр - указатель на TDirectExcel, второй параметр - код акта передачи денег. АПД выводится на текущий лист объекта TDirectExcel.

'''CreateSpecialSMA(ClientCode, DateTo)''' - Функция создает исходящий акт передачи денег (АПД). Требует ClientCode - код клиента, DateTo - дату акта. Функция возвращает коды созданных актов. Если возвращаемых параметров два, значит функция пыталась создать два АПД: первым, идет код АПД с наличной оплатой, а вторым с безналичной. Примеры возвращаемого результата: '0'- акт не был создан, отсутствуют корреспонденции; '124' - код созданного акта; '0,0' - пытались создать два акта, но отсутствуют данные; '4556,0' - создан только наличный АПД; '0,445' - создан только безнал.; '4556,445' - созданы нал. и безнал.

'''CreateAddressForActDelivery(ActCode, [DeliveryDateMode=0, Delivery=True])''' - Функция создает корреспонденцию на доставку акта. ActCode - код акта; DeliveryDateMode: 0 - установить план. дату доставки текущим рабочим днем, 1 - установить план. дату доставки следующим рабочим днем, 2 - установить план. дату доставки равной планируемой дате оплаты АПД; Delivery - создать корр. на доставку АПД или создать корреспонденцию на забор АПД (по умолчанию, доставка АПД). Работа функции может быть изменена системной доп. возможностью OnCreateAddressForActDelivery.

'''CreateAddressTransferAct(ClientCode, Store, DateTo, [AdditionalParam])''' - Функция создает исходящий акт передачи корреспонденции (АПК). Требует ClientCode - код клиента, Store - код филиала, для которого будет создан акт, DateTo - дату, до которой в акт попадут возвраты, AdditionalParam - дополнительный строковый параметр для передачи в системную доп. возможность ExceptionsForAPK, позволяющий отобрать в акт, например, только полные возвраты. Возвращает код созданного акта. ВНИМАНИЕ: при создании АПК используется системная функция ExceptionsForAPK. Если в ней используются интерактивные функции (вывод сообщений, диалоговые окна, выполнение скриптов), то акт сформирован не будет, а функция CREATEADDRESSTRANSFERACT вернет ошибку.

'''GetPolygonByAddress(Address, TownCode, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попал адрес. Если полигон найти не удалось, функция возвратит пустую строку. Address - адрес корреспонденции текстом; TownCode - код города; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByAddress(addressrecord.address, if((addressrecord.number=0)*(addressrecord.strbarcode=<nowiki>''</nowiki>), addressrecord.townfrom, addressrecord.townto), '`schema`=1') - пытаемся найти вхождение адреса в полигоны 1 схемы, при выборе города учитывается корр. на забор, у нее нужно использовать город-отправитель (а для обычной корр. нужен город-получатель).

'''GetPolygonByLatLon(Lat, Lon, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попали GPS координаты. Если полигон найти не удалось, функция возвратит пустую строку. Lat - широта текстом; Lon - долгота текстом; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByLatLon('55.769064','37.590713','zone is not null and price=0') - пытаемся найти вхождение координат в полигоны, где задана зона, для всех клиентских и курьерских зон.

'''GetLatLonByAddress(AddressText, TownCode)''' - возвращает географические координаты вида lat,lon указанного в AddressText адреса. Поиск производится в городе, имеющем код TownCode в таблице Town.

'''GetRouteCode(AddressText, TownCode, LatLon[, Lon])''' - для адреса AddressText в городе с кодом TownCode (из таблицы Town) по географическим координатам lat, lon возвращает код роута (записи, хранящей координаты адреса в городе). Если роут не найден (для адреса в городе не найдено записи с указанными координатами) - создает новый роут и возвращает его код, если роут найден (был создан ранее) - обновляет у роута координаты. Если параметр Lon задан, то параметр LatLon должен содержать одну координату, иначе LatLon должен содержать строку вида 'lat, lon'.
В случае ошибки возвращает Null.

Пример: 
Set($res, GetRouteCode(address, townto, '55.114034, 36.592397')); 
Set($res, GetRouteCode('Троицк, Полковника милиции Курочкина ул., 11', 1, '37.467446, 55.740537')); 
Set($res, GetRouteCode('Обнинск, Маркса пр., 20', TownByName('Обнинск'), 55.114034, 36.592397));

'''CalcAgentPrice(AddressCode, AgentCode, TownFrom, TownTo, Mode, [, Count=1])''' - функция возвращает стоимость доставки рассчитанную по тарифу агента. AddressCode - код адреса, AgenCode - код филиала (агента), TownFrom - код города отправителя, TownTo - код города получателя, Mode - режим срочности, count - тарифная сетку от указанного количества отправлений (по умолчанию 1)

'''SetAddrKol_vo(address, getkol_vo)''' - функция делает прием корреспонденции в текущем ответственном филиале. address - внутренний код адреса, getkol_vo - количество принимаемых мест, может принимать значения: "kol_vo" - принять все места, "getKol_vo+1" - принять еще одно место, "число" - сделать количество принятых мест равным указанному числу.

'''CalcClientCnt(client_code, date, is_intown [, date_put=CurrDate(), skipajust=false])''' - функция расчета количество доставленных корреспонденций у клиента с кодом client_code за предыдущий месяц от даты date (Или за текущий месяц, подробнее смотри переменную UseCurrentMonthCount) среди внутригородских (is_intown = true) либо междугородних (is_intown = false) корреспонденций, date_put - дата доставки (для альтернативного способа подсчета, включаемого переменной UseDatePutForCalcCnt), skipajust - не учитывать принудительно введенные количества (таблица priceclientadjust типы записей 0 и 1).

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset._self".
Описание некоторых полей датасета:
pmoney - процент от суммы;
pmoneycard - процент от суммы при оплате картой;
pricecode - код прайса (таблица Price) ;
distarea - район метро получателя (актуально при отключённом едином районировании, как правило район от 200 до 299 является признаком области);
region - признак области при включенном едином районировании;
distareaFrom и regionFrom - аналог distarea, region только для отправителя;
pcncode - код записи таблицы pricecnt "количество от";
Запрос содержит поля таблицы pricelinesnew - начальная стоимость по тарифной сетки, найденные без учета массы,только по типу срочности и режиму.
Запрос содержит поля таблицы price.

*addressrecord - ссылка на объектную модель карточки корреспонденции, следует использовать уже созданную addressrecord._self
*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*type - тип корреспонденции;
*mode - режим доставки;
*wait - количество минут ожидания (не учитывается при доп. услугах, есть системная услуга "ожидание");
*mass - масса отправления;
*rur - сумма передаваемых денег (не учитывается при доп. услугах, есть системная услуга "процент от суммы");
*inshprice - сумма страховки (не учитывается при доп. услугах, есть системная услуга "процент от объявленной стоимости");
*distance - расстояние до места доставки, обычно поле заполняется при доставке в область (регион в едино районировании). Дополнительная наценка к стоимости доставки;
*forward - направление доставки: true - туда; false - обратно;
*Collection - признак заборной корреспонденции: true - забор, false - доставка (В тарифе есть возможность указать стоимость для забора);
*TownFrom - код города отправителя;
*TownTo - код города получателя.

В тарифе есть возможность указать формулу, которая может влиять на базовый расчет. Формула может объявить служебные переменные, которые:
*$FormulaReplace - если true – возвращаемое значение полностью заменяет базовый расчет;
*$FormulaKoeff - коэффициент на который будет помножена базовая стоимость.
Также внутри формулы объявлены следующие объекты dataset, addressrecord и переменные:
*$ForceIntown - Переменная становится истиной, если междугородний расчет был отменен, т.к. адрес попал в нарисованную зону на карте.
*а также: $forward, $distance, $Count, $Collection, $Wait, $FormulaKoeff, $PriceCode - описание есть выше.

Для направления "туда", Функция GetBasePrice вызывается через доп. услугу "База" (при включенных доп. услугах), для направления "Обратно" всегда вызывается напрямую (т.к. доп. услуги работают только в для направления "туда").
На расчет этой функции влияют следующие переменные: "Финансы" -> "Расчет стоимости по адресу", "Финансы" -> "Зона клиента по умолчанию", "Финансы" -> "Подсчет кол-ва отправлений за месяц".

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset.self".

*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*tp - тип корреспонденции;
*mode - режим доставки;
*mass - масса отправления;
*TownFrom - код города отправителя;
*TownTo - код города получателя.

'''CalcAddressPrice(AddressCode, [,ZakazCount])''' - полностью пересчитывает стоимость доставки корреспонденции по тарифу клиента. AddressCode - внутренний код адреса, ZakazCount - не обязательный параметр, кол-во заказов от клиента.

'''GetStationCode(s [,town])''' – возвращает код станции метро, ассоциированный в системе с адресом s. В случае невозможности идентифицировать станцию метро – возвращает 0.
Когда включено районирование по карте, необходим второй параметр "town" - код города в котором нужно искать адрес. Возвращает код района если удалось его найти; код станции меж-города - если адрес удалось геокодировать, но район не нашли; код 0 - когда не удалось геокодировать адрес.

'''RecalcSpecialSMA(ActCode)''' - пересчитать акт передачи денег (АПД). Также, у корреспонденций входящих в АПД будет пересчитана стоимость доставки. Для Входящего АПД сумма акта не пересчитывается. Параметр ActCode - внутренний код акта, коды можно перечислять через запятую.

'''UserCode''' - Возвращает код текущего пользователя из таблицы «Пользователи» (users).

'''UserName''' - Возвращает имя текущего пользователя из таблицы «Пользователи» (users).

'''UserPass''' - Возвращает пароль текущего пользователя.

'''UserBaseCode''' – Возвращает код текущего пользователя из таблицы «Сотрудники» (kurier).

'''UserEmail''' - Возвращает e-mail текущего пользователя.

'''CurrentTown''' – Возвращает код текущего города (из таблицы town).

'''CurrentCity''' – Возвращает код текущего региона (из таблицы city).

'''CurrentLocation''' – Возвращает код текущего филиала (из таблицы store).

'''FromEmailStr''' - строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

'''FillExcelDoc'''(Excel, Dataset, FormType, FormNumber,Print,[printer]) - Выполняет указанную печатную форму в объекте excel. Excel объект можно не указывать, тогда функция сама создаст объект экселя и разрушит его, полезно когда книгу
нужно распечатать или отправить по email (на листе данных в ячейке 1,1 укажите ключевое слово email). Dataset объект с данными для скрипта в печатной форме, может быть null. Dataset передавать можно так db.self, тогда переданный dataset внутри печатной формы будет доступен по имени dataset. Print - печатает книгу на принтере, после печати объект excel разрушается, при использовании параметра не указываете объект excel. Printer - имя принтера, на котором печатать (по умолчанию пустая строка, что означает "печатать на принтере по умолчанию"). Например:

new('TExcel', 'excel');
FillExcelDoc(excel.self, null, 12, 1);
excel.DoNotDestroy(true);
excel.SetVisible(true);
''Покажет эксель с выполненной печатной формой''

'''ValutaSign''' – Возвращает название валюты для суммы.

'''SendToMeasoft(xml)''' - Отправляет запрос в клиентское API Measoft. Автоматически добавляет начальный "<?xml version="1.0" encoding="utf-8"?>".

'''InsertFirmAtt(excel, sheet, firmcode)''' - Вставляем на лист эксель по коду фирмы: печать, подпись, подпись бухгалтера, логотип. Тэги <STAMP>, <DIR>, <BUH>, <LOGO> соответственно. После тега можно указать размеры изображения в символах Microsoft Excel. Формат записи: <STAMP> 16, 16

'''PreCalcSalary(kurier, addressCodes)''' - Рассчитывает предварительную зарплату. Kurier - код курьера, используется для определения тарифа. addressCodes - коды адресов, через запятую для которых необходимо посчитать зарплату. Результаты расчета будут записаны в таблицу kurierpaydetail, так как расчет предварительный то записи не будут прикреплены к конкретному начислению.

select a.code, kpd.price as "туда", kpd2.price as "обратно" from address a
left join kurierpaydetail kpd on kpd.sourcetable=3 and kpd.sourcecode=a.code and kpd.rectype = 1
left join kurierpaydetail kpd2 on kpd2.sourcetable=3 and kpd2.sourcecode=a.code and kpd2.rectype = 2
where a.code in (...)

'''CalcSalary(DateTo, [Filter=0, KurierCode = 0, ManagerCode = 0])''' - Полный расчет зарплаты курьерам. DateTo - дата до которой создается начисление. Условия отбора курьеров для начисления. Filter - роль сотрудника: 0 - Все, 1 - курьеры, 2 - менеджеры; KurierCode - код курьера, ограничить расчет зарплаты одним курьером;ManagerCode - код курьера, ограничить расчет зарплаты курьерами указанного менеджера. Внимание фильтры Filter, KurierCode и ManagerCode накладываются друг на друга. Результатом функции является SubSQL с информацией по созданным начислениям.
поля ответа: код курьера, код менеджера, начислено, бонусы, штрафы, аванс, итого;
select kurier, manager, profit, bonus, shtraf, prepay, total [union select ...]

'''SelDistAddr(s)''' – Возвращает строку для вставки в select запрос, для вывода поля с упрощенным адресом. Принимает один необязательный строковый параметр - алиас таблицы из которой будет упрощаться поле address, по умолчанию "a"

'''VoiceReadStr(str)''' – Озвучивает фразу str голосовым уведомлением доступными словами из базы. Может содержать тег "{break_off}" для того, чтобы сделать эту фразу не пропускаемой в очереди воспроизведения.

'''CalcStorageCost(ClientCodes, DateFrom, DateTo, NeedReport[, Store])''' – рассчитывает стоимость хранения на складе для выбранных клиентов (ClientCodes - коды клиентов через запятую), в период дат с DateFrom до DateTo, с прикреплением к корреспонденции отчета в зависимости от выставленного параметра NeedReport. Может содержать параметр Store - код филиала, по умолчанию пустой (расчет выполняется для всех филиалов). Возвращает коды созданных корреспонденций через запятую.

'''WriteOut(DocId, ItemId, Date, Cnt[, BC])''' – производит списание товара со склада. DocId - код (docs.code) документа списания, ItemId - код товара (item.code), Date - дата операции, Cnt - количество списываемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер. Если указан BC, то параметр ItemId игнорируется и поиск номенклатуры происходит исключительно по штрих-коду. В случае успеха, функция возвращает строку вида: код номенклатуры, списанное кол-во.

'''IncomePurch(DocId, ItemId, Date, Cnt[, BC, Location = CurrentLocation])''' – производит приход товара на склад. DocId - код (docs.code) приходной накладной, ItemId - код товара (item.code), Date - дата операции, Cnt - количество приходуемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер, Location - код склада (store.code). В случае успеха, функция возвращает строку вида: код номенклатуры, введенное кол-во.

'''CreateLedgerDoc(Date, Client, UserCode, Type[, ExtNumber, Message])''' - создает складской документ и возвращает код этого документа. Date - дата документа. Client - код клиента. UserCode - код пользователя, создавшего документ. Type - тип документа (statetype = 13). ExtNumber - номер у поставщика для документов прихода и расхода. Message - комментарий к документу. Последние два аргумента не обязательные и могут быть пустыми.

== Объект TINIFile ==

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

Функции:

IniParam(s[,section='common']) – Существует только если имя экземпляра объекта пустое. Возвращает значение параметра s ini-файла секции «common», изменить секцию можно не обязательным параметром section. В случае отсутствия параметра в файле возвращает пустую строку.

Param(s) – Синоним IniParam с тем отличием, что существует только если имя объекта непустое.

SetText(s) - Загружает ini файл из строки s. Если в файле нет секции «common», то принудительно объявляет ее в начале.

== Объект TSMS ==

Предназначен для отправки SMS, а также проверки статуса их доставки.

Функции:

SetProxy(Server, Port, User, Pass) - Устанавливает настройки прокси-сервера.

Connect(Provider, Host, User, Pass, SenderName, SMSPrefix) – Подключает объект к провайдеру provider, используя адрес Host, имя пользователя User и пароль Pass. Значение SMSPrefix предназначено для того, чтобы провайдер мог различить сообщения от разных филиалов, если этими филиалами используется одно подключение. Если необходимости разделять сообщения нет - значение SMSPrefix можно не указывать.
Для провайдера доступны значения 'mirsms', 'sms16', 'websms', 'epochta', 'zanzara', 'SMSManager', 'f1sms', 'BitCall', 'mirsmsGET', 'AMD' и другие, либо можно указать числовые значения номера протокола, от 1 до <rspoiler text="20">Набор провайдеров все время дополняется, количество и номера можно смотреть в Справочники - Переменные - Подключения - SMS</rspoiler> соответственно. Эти значения соответствуют значениям переменной SMSProtocol таблицы "Value".

SendSMS(Phone, Text, [ID]) – Отправляет SMS с текстом Text на телефон Phone. Для некоторых провайдеров необходим уникальный идентификатор сообщения ID (для провайдера iVoice - идентификатор сценария (кампании)). Возвращает ID провайдера для последующей проверки статуса доставки.

CheckSMS(ProviderID) – Проверяет состояние доставки сообщения с идентификатором ProviderID. Возвращает: 0 – доставляется, 1 – успешно доставлено, 2 – не доставлено.

ReceiveSMS(InboxID, DateFrom, DateTo, NewOnly) - Получает входящие SMS, с ящика InboxID (идентификатор выдаётся провайдером). DateFrom, DateTo - задается временной интервал в котором были приняты сообщения(формат 08.04.2013 18:00:00 'DD.MM.YYYY HH:NN:SS'). Чтобы получать только новые сообщение поле NewOnly должно быть True. Возвращает XML с сообщениями.

ExtraResult([ParamName='']) - Вызывается после CheckSMS, возвращает дополнительную информацию по последнему статусу смс. В настоящее время работает только для провайдеров BitCall и iVoice. Для BitCall по умолчанию возвращает кнопки, нажатые абонентом во время работы с голосовым меню. Если в paramname указать 'IdentifyText' то будет возвращен JSON с ответами абонента на заданные вопросы(используется в случае звонков с индивидуальным сценарием). Для iVoice по умолчанию подразумевается параметр 'response', при этом будет возвращен JSON с ответами абонента на заданные вопросы (в зависимости от сценария)

Log - Возвращает последний HTTP запрос и ответ от сервера смс.

== Объект TXML ==

Предназачен для парсинга XML-данных.

Функции:

SetText(S) – Задает текст XML документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию. Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

AttribCount – Возвращает количество атрибутов текущего элемента.

AttribName(i) – Возвращает имя атрибута с номером i.

Attrib(V) – Ищет атрибут и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

Reset – Делает текущим корневой элемент, возвращает его значение.

== Объект TJSON ==

Предназачен для парсинга JSON-данных.

Функции:

SetText(S) – Задает текст JSON документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Можно проверять наличие элементов, если элемента нет, вернется пустая строка.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

Reset – Делает текущим корневой элемент, возвращает его значение.

isArray - Возвращает true, если текущий элемент является массивом (доступ к дочерним элементам возможен только по индексу, нумерация элементов начинается с нуля)

==Объект TZip==
Предназначен для работы с Zip архивом.

SetZip(s) - Загружает архив в объект из строки s;

GetZip - Возвращает архив в виде строки;

AddFromFile(SrcPath, ZipPath) - Добавляет файл SrcPath в архив и располагает его по пути ZipPath. ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

AddFromStr(Data, /*ZipPath*/) - '''параметр ZipPath временно не работает'''. Добавляет файл из строки Data в архив и располагает его по пути ZipPath. -ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

LoadFromFile(path) - Загружает архив из файла path;

SaveToFile(path) - Сохраняет архив в файл path;

Count - Возвращает кол-во файлов в архиве;

DataByIndex(index) - Возвращает распакованный файл в виде строки. Index - номер файла в архиве;

DataByName(ZipPath) - Возвращает распакованный файл в виде строки. ZipPath - путь к файлу в архиве, может содержать каталоги;

FileName(index) - По номеру файла, функция возвращает полный путь файла в архиве.

==Объект TBase==

'''Функции общего назначения''':

'''ExecSimpleScript(Caption, Text)''' - Выполняет скрипт "Дополнительных возможностей". Возвращаемые значения, введенные пользователем устанавливает в переменные $scriptvar1..$scriptvarN, Значения кодов списочных переменных - в переменных $scriptvar1codes..$scriptvarNcodes. Функция возвращает истину, если пользователь нажал "OK" в диалоговом окне.

'''FillAdvPriceReport(Excel, AddressCodes, StartLine, StartCol, [ShowSumPrice,InsertColumns,ShowAll])''' - добавляет отчёт по дополнительным услугам. В AddressCodes - указаны коды адресов через запятую, каждый код это отдельная строка отчета. Адреса будут показаны в порядке перечисления их в AddressCodes. Если в отчет нужно добавить пустую строку, то можно указать код адреса -1000. StartLine, StartCol - верхний левый угол выгружаемой таблицы. ShowSumPrice - добавить столбец итоговый столбец с суммой всех услуг, по умолчанию выключено. InsertColumns - раздвинуть таблицу перед вставкой отчета, позволяет встраивать отчет посередине выгрузки, по умолчанию выключено. ShowAll - показать все дополнительные услуги, по умолчанию false и показывает только услуги с начислениями. Функция возвращает количество использованных столбцов.

'''PrintSticker(Codes, [ToBoxes=False])'''

'''PrintBlanc(Codes, BlancNumber)''' - печатать форму из раздела "Заполнить бланк". Codes - коды корреспонденций, BlancNumber - номер формы из раздела "Бланки для корреспонденции" (3)

'''GetItemByName(Name)'''

'''GetA4Printer''' - возвращает имя принтера выбранного для печати документов

'''GetStickerPrinter''' - возвращает имя принтера выбранного для печати стикеров

'''GetDuplexPrinter''' - возвращает имя принтера выбранного для двусторонней печати, если принтер не выбран, возвращает пустую строку

'''PrintAttachPDFPage(Code, FileName, Page, Printer)''' - печатает страницу из вложенного файла PDF. Code - код вложения (attachment) или путь к файлу, Page - номер страницы, Printer - 0 = принтер A4, 1 = принтер этикеток.

'''AttachPDFToText(Code, [TextFileName])''' - преобразует файл PDF из вложений в текст. Code - код вложения (attachment) или путь к файлу, TextFileName - имя текстового файла, в который записывается результат (если не указан, используется временный файл). Возвращает текст в виде строки.

'''GhostScript(GScript, Code)''' — функция для выполнения консольных команд утилиты [https://ghostscript.readthedocs.io/en/latest/Use.html ghostscript]. Где, GScript — строка с командами Ghostscript; Code — код вложения или путь к PDF-файлу, предназначенному для обработки. В командах доступен специальный тег %MeasoftInFile%, который автоматически заменяется на путь к предварительно загруженному файлу (Code). Если в команде необходимо указать путь для сохранения результата обработки, используйте тег %MeasoftOutFile%. В этом случае функция на основании параметра Code автоматически сформирует имя временного выходного файла. После успешного выполнения команд функция возвращает путь к сгенерированному выходному файлу - %MeasoftOutFile%.

'''GetActiveForm([SkipFormName])''' - возвращает код активной формы в программе где происходит сканирование. SkipFormName - не обязательны параметр, имя формы которую нужно пропустить при определении интерфейса.
'''Список интерфейсов''':
0 - неопределенный;
1 - прием корреспонденции на склад;
2 - АПД;
3 - комплектация адресов (ShelfingForm);
4 - доска приема;
9 - вкладка «Манифесты»;
10 - Инвентаризация корреспонденции;
11 - АПК;
12 - вкладка «Адреса»;
13 - вкладка «Выдача»;
14 - вкладка «Склад»;
15 - Список номенклатуры;
16 - Инвентаризация склада;
17 - Приходная накладная;
18 - Списание товара;
19 - Карточка корреспонденции.

'''AddAddressScanLog(Code[, StrBarCode, IsManual, FromInterface, ExtraInfo])''' - добавляет событие сканирование для корреспонденции с кодом Code. Необязательные параметры: StrBarCode - сканируемый ШК корреспонденции (по умолчанию пустой), IsManual - галка ручного сканирования (по умолчанию false), FromInterface - код интерфейса сканирования (StateType=81, по умолчанию 0 - неопределенный), ExtraInfo - текстовый комментарий события.

'''RuleName(alias)''' - Выдает полный путь в дерева прав по псевдониму права.

'''ShowText(Caption:string, Value:string)''' - показывает пользователю окно с заголовком Caption и с многострочным полем со значением Value. Может быть полезен при отображении логов выполненной операции.

'''ShowScanError(msg [, Speek, Color, Abort])''' - выдает пользователю окно с текстом msg блокируя последующие действия сканирования. Если Speek - истинно, то сообщение проговаривается голосовым движком, по умолчанию выключено. Color - целочисленное число цвета, в который будет окрашен фон сообщения (по умолчанию = -1, стандартный). Abort - прервать выполнение скрипта, не показывая ошибку.

'''CheckRule(alias)''' - функция проверки разрешения у текущего пользователя системы, alias - псевдоним права. Возвращает 1, если право есть и 0, если права нет.
Пример: if(CheckRule('RSE'), ShowMessage('У пользователя есть право изменять счета'), ShowMessage('У пользователя нет права изменять счета'));

'''GetKurierMoney(KurierCode, DateEnd, NonCash)''' - возвращает баланс курьера с кодом KurierCode на дату DateEnd. NonCash - булевый флаг, если истинно, то будет рассчитан безнальный баланс;

'''Функции, работающие только в импорте БД из эксель:'''

ReplaceAddress

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

GetPrice

GetNewNumber - используется при импорте реестра, возвращает номер конверта в загружаемом заказе

GetNewPos - используется при импорте реестра, возвращает порядковый номер вложения

GetNewPackagePos- используется при импорте реестра, возвращает порядковый номер места

Zakaz - возвращает номер заказа куда происходит импорт реестра

addresscode - используется при импорте реестра, код созданного адреса

Source - код заказчика

ClientTown - Узнаем город клиента, через филиал с которым он работает. Сам клиент берется из заказа указанного в окне "Импорт БД из Excel".

== Объект TFieldObject ==
Создается только автоматически. Объект для доступа к записям, используется в картах и дополнительных услугах (addressrecord) и событиях карточки корреспонденции (fieldlist). Методы объекта:

'''_GetTableInfo''' - возвращает данные о полях и примеры данных объекта.

'''_Self''' - возвращает ссылку на объект.

'''_Set(fieldname, fieldvalue [, DoUpdateForm])''' - Если базовый объект строка. Устаналивает для поля fieldname значение fieldvalue. DoUpdateForm по уолчанию false, если указать true то обновление поля будет не только в объекте но и пользовательском интерфейсе. Обновление работает только в карточке корреспнденции для ограниченного набора полей: vlog, mode, type, date_put, time_put, message, kurier, state1.

'''_Set(keyfield, keyvalue, filed, value)''' - Если базовый объект таблица (addressrecord.boxes). Работает перегруженная версия метода _set, cначала происходит поиск строки по ключу, далее меняется значение указанного столбца. keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Пример, отключение услуги база:

addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

== Объект TMessage ==
Создается только автоматически. Объект используется для скриптовой обработки письма в [https://wiki.courierexe.ru/index.php/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F_%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8#.D0.98.D0.BC.D0.BF.D0.BE.D1.80.D1.82_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85| заданиях импорта данных]. В себе содержит текст письма в очищенном формате и оригинальном формате HTML, отправитель письма, тему письма, дата получения и список прикрепленных файлов.

'''Message.Text''' - возвращает очищенный от HTML-тегов текст письма.

'''Message.HTMLText''' - возвращает оригинальный текст письма со всеми HTML-тегами.

'''Message.Sender''' - возвращает email-адрес отправителя письма.

'''Message.AttachmentsCount''' - возвращает количество вложенных файлов.

'''Message.DateTime''' - возвращает дату и время получения письма.

'''Message.Subject''' - возвращает тему письма.

'''Message.GetAttachmentDataString(Number)''' - возвращает вложенный файл под номером Number в виде строки.

'''Message.GetAttachmentName(Number)''' - возвращает имя вложенного файла под номером Number.

== Объект TStringList ==
Может использоваться для построчной обработки многостраничных файлов либо для организации текстовых данных. Номер строк начинается с 0.
Имеет следующий функционал:

'''Count''' - возвращает количество строк в списке.

'''Add(Value:string)''' - добавляет значение Value в конец списка.

'''SetText(Value:string)''' - устанавливает значение списка в значение Value.

'''Insert(Number:integer, Value:string)''' - добавляет строку Value в позицию Number.

'''Delete(Number:integer)''' - удаляет строку из списка в позиции Number.

'''Clear''' - очищает элементы списка.

'''LoadFromFile(Path:string)''' - загружает текстовый файл по пути Path.

'''Strings(Number:integer)''' - возвращает строку с номером Number.

'''SetString(Number:integer, Value:string)''' - устанавливает значение строки с номером Number в значение Value.

'''Text''' - возвращает полный список строк в виде текста.

'''CommaText([Quoted:boolean])''' - возвращает список значений через запятую. Если Quoted = true, то квотирует элементы списка. По умолчанию равен false.

'''SetCommaText(Value: string)''' - разбивает значение Value на отдельные строки и кладет в список. Разделитель - запятые.

'''IndexOf(Value:string)''' - ищет значение Value среди элементов списка и если находит, то возвращает номер строки. Возвращает -1 если значение не было найдено.

'''Sorted(Value:boolean)''' - устанавливает флаг отсортированности списка в Value. Если Value = true, то сразу же его сортирует. По умолчанию Value = false.

'''Exchange(Pos1:integer, Pos2:integer)''' - меняет элементы списка с позициями Pos1 и Pos2 местами.

'''Duplicates(Value:integer)''' - изменяет параметр управления дубликатами в списке. Если Value = 0 (значение по умолчанию), то список не реагирует на дубликаты. Если Value = 1, то список при добавлении будет игнорировать дубликаты. Если Value = 2, то список будет выдавать исключение, при добавлении дубликата в список.

'''ParamName(Number:integer[, Delimiter:string])''' - возвращает текст до первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает пустоту.

'''ParamValue(Number:integer[, Delimiter:string])''' - возвращает текст после первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает всю строку.

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

Основные методы:

'''New'''(FuncName, Param1, Param2, ..., Body) — создание новой функции.Функция возвращает результат выполнения последней команды в теле функции. Аргументы:
* `FuncName` — имя функции (строка)
* `Param1, Param2, ...` — имена параметров функции (переменные начинаются с `$`, объекты — без префикса)
* `Body` — тело функции (скрипт, выполняемый при вызове)

'''FuncName'''(Arg1, Arg2, ...) — вызов созданной функции по имени. Если в объявлении была указана тип переменная, то и подставлять в аргумент надо обязательно переменную. Будет передано значение этой переменной (переменные словарине поддерживаются!). Если был объявлен объект, то указатель на объект должен быть получен через метод '''_self'''. C функциями поддерживают работу следующие классы: TExcel, TDirectExcel, TCSVFile, TADO, TSelfADO, TPrinter, TCanvas, TPicture, TTable, TINIFile, TSMS, TXML, TJSON, TZip, TStringList, TBaseUtils, а также объект addressrecord (TFieldObject). Результатом работы функции может быть число или строка.

Пример 1, обработка результатов функции:
<source>
<?>
new('TFunc', 'calc');
calc.new('Sum', '$a', '$b',
$a + $b
);

set($x, 10);
set($y, 20);
showmessage(calc.Sum($x, $y));
</source>

Пример 2, передача объекта в функцию:
<source>
<?>
new('TFunc', 'utils');
utils.new('ProcessDB', 'dbConn', '$value',
showmessage($value);
dbConn.open('SELECT * FROM address limit 3 ');
if(dbConn.recordcount > 0,
showmessage('Найдено записей: ' + dbConn.recordcount);
dbConn.first;
while(dbConn.eof = 0,
showmessage(dbConn.fieldbyname('code'));
dbConn.next
)
,0)
);

new('TSelfADO', 'db');
utils.ProcessDB(db._self,'test!');
</source>

== Применение языка формул ==
'''в различных контекстах системы «MEASOFT» и сопутствующих проектах'''

=== MEASOFT ===

==== Дополнительная информация на чеке ====

В карточке клиента на закладке «Касса» имеется поле для ввода текста, который будет отображаться на кассовых чеках, печатаемых для корреспонденции от данного клиента. В поле может быть введен как просто текст, так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TSelfDB с открытым набором данных со строчкой корреспонденции, заказа и клиента, на которую печатается чек

TBaseSupport

TBaseValue

Все объекты создаются с пустыми именами.

Так же система записывает в переменную $CashRegisterID вычисленный код фискального регистратора, на котором предполагается печать чека.

Результат работы скрипта печатается на создаваемом чеке, если скрипт не возвращает значение “-1” (число или текст) – в этом случае система чек не создает. Подразумевается, что либо скриптом было принято решение об отсутствии необходимости формирования чека, либо скрипт взял эту функцию на себя.

==== Заполнение шаблонов печатных форм ====

==== Дополнительные возможности ====

==== Импорт БД из Excel ====
В окружении интерпретатора создается объект ZakazRecord, он является списком со значениями таблицы zakaz. Именно в этот заказ будут загружены данные. Из этого объекта также доступно : 
*ZakazRecord.userfields - пользовательские поля заказа;
*ZakazRecord.Clients - данные таблицы clients;
*ZakazRecord.Clients.userfields - пользовательские поля заказчика.

==== Прайс лист клиента ====

Формула возвращает сумму в валюте клиента для каждой поездки (туда или обратно) единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Помимо стандартных объектов, система создает объект AddressRecord, в котором, как свойства, доступны все поля текущей записи. Так же она выставляет значение переменной $Forward в 1 (истина), если необходимо произвести расчет для направления "Туда" и 0 (ложь) - если обратно. ВНИМАНИЕ! Как и во всех остальных местах, после формулы нельзя ставить ";", иначе скрипт вернет 0!

Например:

if(int(AddressRecord.Time_Put_Max)>19, 100, 0)

''Прибавляет 100 рублей в случае, если максимальный срок доставки 20 часов или более''

if(pos(AddressRecord.Address, 'Аренда')>0,
set($FormulaReplace, 1);
1500
, 0)

''В случае наличия подстроки "Аренда" в адресе заменяет штатное ценообразование на 1500 рублей''

Объект AddressRecord может предоставить доступ к связанным таблицам :
* addressrecord.boxes
* addressrecord.packages
* addressrecord.clients
* addressrecord.price
* addressrecord.advprice
* addressrecord.userfields
* addressrecord.addressfld
* addressrecord.clients.userfields
* addressrecord.price.userfields
* addressrecord.zakaz
* addressrecord.zakaz.userfields

Чтобы получить доступ к полю VarCode из таблицы userfields необходимо записать AddressRecord.Userfields.VarCode. В присоединённой таблице может быть несколько записей чтобы получить к ним доступ предусмотрены функции _First, _EOF, _Next, _RecordCount, _Set.

Пример:
set($value1, 0); set($value2, 0);
while(AddressRecord.userfields._EOF=0,
if(AddressRecord.userfields.varCode=1,
set($value1, if(AddressRecord.userFields.VarValue='Праздничная упаковка', 150, 0)), ''''''');
if(AddressRecord.userfields.varCode=2,
set($value2, AddressRecord.userFields.VarValue), ''''''');
AddressRecord.userFields._Next;
);
int($value1) + int($value2)

Пример делающий тоже самое что и выше но через поиск Locate:
set($value1, if(addressrecord.userfields.VarValue('VarCode', 1)='Праздничная упаковка', 150, 0));
set($value2, int(addressrecord.userfields.VarValue('VarCode', 2)));
$value1 + $value2

В скрипте доступны переменные:
«$FormulaKoeff» - это коэффициент на который умножится конечная цена (по умолчанию равна 1);
«$PriceCode» - код прайса;
«$CurrentPriceConf» - код услуги;
«$BasePrice» - стоимость всех услуг с уровнем (pricelevel) меньше текущего.

Для вызова функции CalcBasePrice (Расчёт базовой цены) в скрипте объявленны переменные: $Count,$Collection,$Distance,$Wait.

Существует поиск по ключевому полю (поиск регистронезависимый), например чтобы найти в таблице advprice введённое значение для текущей услуги, нужно сделать такую запись addressrecord.advprice.value('priceconf', $CurrentPriceConf) - Первый параметр это ключевое поле, второй искомое значение. Если запись найдётся будет возвращено значение поле value, если нет функция вернёт значение 0.

Пример
if(addressrecord.advprice.active('priceconf', 3)='T', addressrecord.advprice.price, 0)

''Смотрим включена ли услуга и если да, возвращаем рассчитанную стоимость

Чтобы изменить значение записанное в объект addressrecord, нужно воспользоваться методом _set(keyfield, keyvalue, filed, value). Параметр keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Сначала происходит поиск строки по ключу, далее меняется значение указанного столбца.
Пример, отключение услуги база:
addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

Также существует упрощенный метод _set, с двумя параметрами filed, value - он используется в шаблонах загрузки или в системных доп. возможностях где доступен объект addressrecord.

==== Зарплата курьеров ====

Формула возвращает сумму в основной валюте для каждой единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Переменные «$FormulaTablKoeff» и «$FormulaMoneyKoeff» позволяют установить повышающий или понижающий коэффициент на стоимость доставки (по тарифной сетке) и услуги соответственно (процент от суммы, процент от стоимости доставки, ожидание). Переменная «$UsingZoneName» и «$KurierZone» содержат название и код зоны соответственно, есть возможность поменять название зоны для отчета.

=== Планировщик ===

В поле текста задания может быть введен как текст с командами планировщика (см ниже), так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TIniFile, Указывает на настроечный ini-файл планировщика.

Все объекты создаются с пустыми именами.

Для записи в лог планировщика нужно использовать функцию Print

=== Репликатор ===

== Прочее ==
ReplaceAddress(target, address) – Возвращает адрес последней доставки корреспонденции получателю target по адресу address от текущего клиента. При отсутствии такой доставки, возвращает address.

GetPrice –возвращает рассчитанное значение цены, на основе прайс-листа клиента и данных о корреспонденции.

GetKurierByStation(i) – возвращает код курьера, ассоциированного со станцией метро с кодом i.

GetNewNumber – Возвращает не занятый номер единицы корреспонденции в текущем заказе.

==История изменений==

=== Недавние изменения ===
{|
||'''Добавлено:'''
|2025.0.0.539 Добавлена поддержка отладчика AttachDebugger
|-
||'''Добавлено:'''
|2025.0.0.534 Добавлена поддержка оператора CASE и класса TFunc
|-
|}

=== Версия 2021.0.0.57 от 18.06.2019 ===
{|
||'''Добавлено:'''
|В объект TExcel добавлен метод ColumnDelete.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция InsertFirmAtt.
|-
||'''Добавлено:'''
||В объект TExcel добавлен метод Align.
|-
||'''Добавлено:'''
|Функция CheckEan
|-
||'''Добавлено:'''
|В объект функцию FillAdvPriceReport добавлены параметры ShowSumPrice,InsertColumns
|-
||'''Добавлено:'''
|В объект TSMS добавлен метод Log.
|-
||'''Добавлено:'''
|Добавлена функция Money.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция ValutaSign.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция GetPolygonByLatLon.
|-
||'''Добавлено:'''
|В объект TTable добавлена функция SetMultiHeader, SetCustomHeader.
|-
||'''Добавлено:'''
|Функция DownloadAttachment
|-
||'''Добавлено:'''
|В функцию SetRowHeight объекта TExcel добавлен параметр cnt.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция AsString.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция SetSize.
|-
||'''Добавлено:'''
|В объект TADO добавлена функция ParseForIn.
|-
||'''Изменено:'''
|В объект TBaseUtils из TBase перенесена функция FillExcelDoc.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция CalcAddressPrice
|-
||'''Изменено:'''
|Все функции класса TBaseSupport перенесены в TBaseUtils. Класс TBaseSupport больше не существует.
|-
||'''Добавлено:'''
|В функции RowInsert и RowDelete объекта TExcel добавлен параметр count.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция SendToMeaSoft
|-
||'''Добавлено:'''
|В объект TBaseUtils функция RecalcSpecialSMA
|-
||'''Добавлено:'''
|Новая функция Reverse
|}

=== Версия 849   22.02.2018 ===

{|
||'''Добавлено:'''
|В функцию TBaseUtils.TownByIndex добавлен параметр PriorityName
|-
||'''Добавлено:'''
|В объекте TBase добавлена функция GetNewPackagePos
|-
||'''Добавлено:'''
|В объекте TSMS доработан метод ExtraResult, добавлен параметр ParamName
|-
||'''Добавлено:'''
|В объект TBase добавлена функция CalcAgentPrice
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateAddressForActDelivery
|-
||'''Изменено:'''
|Функция CalcTownDeliveryDate заменена на CalcDeliveryDate
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateSpecialSMA
|-
||'''Добавлено:'''
|Функция SignatureUrl
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция LoadFromStr.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetPen.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetBrush.
|-
||'''Добавлено:'''
|В объект TPicture добавлена поддержка чтения в формате PNG.
|-
||'''Добавлено:'''
|В функцию TCanvas.DrawPic параметр Mode
|-
||'''Добавлено:'''
|Свойство TPicture.Canvas
|-
||'''Добавлено:'''
|Функция DeleteFile
|}

=== Версия 758   29.03.2017 ===
{|
||'''Добавлено:'''
|Функция GetPolygonByAddress
|-
||'''Добавлено:'''
|Функция ParamsCount
|-
||'''Добавлено:'''
|Объект TZip
|-
||'''Изменено:'''
|Функции CreateEAN и Create128 заменены одной функцией CreateBar, полностью совместимой с Create128, но добавлена поддержка EAN-13 и Interleaved 2-5 (для Почты России). В системе функции оставлены для обратной совместимости, но более не являются документированными и рекомендованными к использованию.
|-
||'''Добавлено:'''
|Параметр text в функцию Cell объекта TExcel
|-
||'''Добавлено:'''
|Функция UrlEncode
|-
||'''Добавлено:'''
|Функция IncDay теперь может принимать параметр count
|-
||'''Добавлено:'''
|Функции FtpGet, FtpPut, TTable.SetCell()
|}

=== Версия 452   26.02.2014 ===

{|
||'''Добавлено:'''
|Функция Time
|-
||'''Добавлено:'''
|Функция FixedIntToStr
|-
||'''Добавлено:'''
|Функция TimePeriod
|-
|'''Добавлено:'''
|В интерпретатор добавлена функция приёма смс - ReceiveSMS
|-
|'''Добавлено:'''
|Функция STR2UTF
|-
|'''Добавлено:'''
|Функция SAVETOFILE
|-
|'''Добавлено:'''
|Функция TExcel.SetSheetName
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "FILESTR"
|-
|'''Добавлено:'''
|Расширены возможности объекта addressrecord в формулах тарифов
|}

=== Версия 308   24.11.2012 ===

{|
|'''Добавлено:'''
|В функции загрузки таблиц из TADO добавлено условие, что поля, названия которых начинаются с "-" не выгружаются. Таким образом можно скрывать служебные поля из результирующего набора.
|-
|'''Добавлено:'''
|Функция TExcel.RowAutoFit
|-
|'''Добавлено:'''
|Функция TExcel.RowInsert
|}

=== Версия 300   01.11.2012 ===

{|
|'''Добавлено:'''
|В объекте TCSVFile добавилась возможность запрашивать значения не только текущей записи через параметр сдвига
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "UPDOWN"
|-
|'''Добавлено:'''
|В интерпретатор добавлен объект TCSVFile
|}

=== Версия 266   14.09.2012 ===

{|
|'''Добавлено:'''
|В интерпретатор добавлена поддержка массивов
|}

=== Версия 265   11.09.2012 ===

{|
|'''Добавлено:'''
|Функция CreateTrans в интерпретатор
|-

Руководство программиста

2026-01-07T18:58:44Z

Sammy: /* Объект TBase */

== Основные положения ==

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

Как интерпретатор приводит типы:

1. При использовании значения как параметр функции интерпретатор автоматически приводит значение к типу, необходимому функции.

2. При операциях сложения, а также логических операциях, операнды приводятся к строке если хотя бы один из них имеет тип «строка». Например:
3.3+5 -> 8.3
‘3.3’+5 -> ‘3.35’
подобную проблему можно решить принудительно преобразовав тип:
float(‘3.3’)+5 -> 8.3

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

Как работают функции приведения типов:

1. При преобразовании строки к числу: функция «читает» строку до первого символа, не позволяющего создать число с плавающей точкой, при этом разделителем целой и дробной частей может быть как точка так и запятая. Если приведение производится к целочисленному типу, то после этого происходит округление. Например:
float('3.6qwerty735') -> 3.6
int('3.6qwerty735') -> 4

2. При преобразовании к булевому типу ложью считается пустая строка либо число 0, все остальное - истина

3. При преобразовании булевого типа к числу истина преобразуется в 1, ложь – в 0. Такое преобразование позволяет использовать сложение и умножение в качестве логических «ИЛИ» и «И» соответственно:
if((5=5)+(6=7), <a>, [b]) – условие истинно, выполнится код «a».

4. При преобразовании булевого типа к строке сначала происходит преобразование к числу:
(5=5)+'qwerty' -> ‘1qwerty’

== Описание синтаксиса ==

Команды разделяются точкой с запятой. Параметры функций разделяются запятыми. Каждая команда (даже цикл while) является функцией, возвращающей некоторое значение. Результатом выполнения составной команды (последовательности функций, разделенных точкой с запятой), является результат выполнения последней функции. Имена переменных, функций, объектов, а также их свойств и методов не чувствительны к регистру.
Константы: константы бывают целочисленными, дробными и строковыми. Значения целочисленных и дробных констант указываются «как есть» (в этом случае разделитель целой и дробной частей – точка), шестнадцатеричные значения начинаются с символа «$» и, если первая цифра – буква, она упреждается цифрой 0, а строковые – в одинарных кавычках. При этом, если внутри строковой константы встречается символ одинарной кавычки он должен быть задвоен, для указания интерпретатору того, что он не является признаком конца константы.
Операции сравнения: >, <, =, ! - Больше, меньше, равно, не равно соответственно.
Логические операции: + (ИЛИ), * (И).
Арифметические операции: +, -, *, /
Операция конкатенации строк: +

=== Функциональность базового объекта ===

'''SET($a, a)''' – присваивает переменной (1-й параметр) значение второго параметра. При отсутствии переменной – создает ее. Имена переменных должны начинаться с символа «$», а следующий символ не должен быть цифрой. Возвращает новое значение переменной. Функция используется только для задания значений переменных. Не допускается использования для задания значений свойств объектов. Для этого используются соответствующие методы этих объектов.

'''IF(a,b,c)''' или '''IF(a,b)''' – Условный оператор. В первом случае возвращает b, если a истинно (не равно нулю или пустой строке), иначе – c. Во втором случае – возвращает a, если оно истинно, иначе – b.

'''WHILE(a, b)''' – Оператор цикла. Выполняет b пока a истинно:
set($i, 10);
set($sum, 0);
while($i>0, set($sum, $sum+$i); set($i, $i-1));
$sum
Результат – 55

'''FOR($a, b, c, d)''' – Оператор цикла. Выполняет d пока $a последовательно присваиваются значения от b до с включительно:
set($sum, 0);
for($i, 1, 10, set($sum, $sum+$i));
$sum
Результат – 55

'''NEW(ClassName, InstanceName)''' – Создает экземпляр класса ClassName, назначает ему имя InstanceName. Возвращает порядковый номер созданного объекта. Доступ к свойствам и методам объектов осуществляется по имени объекта и имени свойства/метода, разделенным точкой. Именем объекта может быть и пустая строка, тогда доступ к его свойствам и методам будет осуществляться без указания имени, и, в случае совпадения имен свойств и/или методов со стандартными или свойствами/методами других объектов, использоваться будут соответствующие свойства/методы объекта, созданного ранее, а также такой объект невозможно уничтожить до окончания выполнения скрипта. Все объекты созданные во время выполнения скрипта уничтожаются автоматически после окончания его выполнения.

'''FREE(InstanceName)''' – Уничтожает объект с именем InstanceName. Возвращает 0. В случае отсутствия объекта с заданным именем вызывает ошибку.

'''ShowObjects''' – Возвращает список созданных объектов – названия классов и имена.

'''ERROR(message)''' – Вызывает ошибку с текстом message.

'''SHOWMESSAGE(message)''' – Отображает диалоговое окно с текстом message, останавливает выполнение скрипта до закрытия окна пользователем.

'''SimpleAskUser(Message)''' – Выводит диалоговое окно с текстом Message и кнопками «Да» и «Нет». Возвращает 1, если пользователь нажал кнопку «Да», иначе – 0.

'''TRY(a)''' – Выполняет a в «защищенном от ошибки» режиме. Если в процессе выполнения a возникает ошибка, возвращает текст ошибки, иначе – 0 (ложь).

'''REM(….)''' – Код в скобках игнорируется (комментарий).

'''EXEC(FileName, Params, Wait, WindowState)''' – Запускает внешнее приложение FileName с параметрами Params. Если Wait истинно – ожидает завершение процесса. Для WindowState доступны следующие числовые значения:
0 - SW_HIDE
1 - SW_SHOWNORMAL (по-умолчанию)
3 - SW_MAXIMIZE
6 - SW_MINIMIZE
Функция возвращает истину если приложение запущено успешно. Иначе – Ложь.
В случае успеха, при параметре Wait – истина кладет в переменную $LastResult код завершения приложения.

'''CASE''' - Оператор множественного выбора. Позволяет выполнить одно из нескольких действий в зависимости от условий. Синтаксис:
<source>
case(
when(условие1, действие1);
when(условие2, действие2);
...
else(действие_по_умолчанию);
);
</source>

Пример использования:
<source>

set($a, 10);
set($b, 50);

showmessage(
case(
when($a < 5, 50);
when($a < 10, 100);
when($a < 250, 200);
else($a*$b);
)
);
</source>

'''AttachDebugger''' - Команда позволяет подключить открытый [[Отладчик_встроенных_скриптов]] к текущему скрипту. Команда AttachDebugger должна быть '''первой командой''' в скрипте. Добавьте её в самое начало скрипта:

<source lang="json">
<?>
AttachDebugger;
set($a, 10);
set($b, 20);
set($sum, $a + $b);
showmessage($sum);
</source>

'''Как работает:'''
# При выполнении команды AttachDebugger скрипт останавливается.
# Отладчик автоматически подключается к выполняющемуся скрипту.
# Текст скрипта загружается в редактор отладчика.
# Можно ставить точки останова, просматривать переменные и продолжать отладку.

'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.
* Если режим отслеживания не включён, команда `AttachDebugger` игнорируется.
* В режиме отслеживания может работать только один отладчик.
* Команда AttachDebugger должна быть первой командой в скрипте.

=== Строковые функции ===

'''UpCase(s)''' – возвращает строку s в верхнем регистре.

'''LCase(s)''' – возвращает строку s в нижнем регистре.

'''Len(s)''' – возвращает количество символов в строке s.

'''Pos(s, substr [,start])''' – возвращает номер первого символа первого включения подстроки substr в строку s, возвращает 0, если включения подстроки отсутствуют. Параметр start - это позиция старта поиска, не обязательный параметр, по умолчанию равен 1. Поиск не чувствителен к регистру.

'''Param(s, i)''' – возвращает i-й элемент строки s, разделенной запятыми на элементы.

'''ParamsCount(s)''' - возвращает количество элементов строки s, разделенной запятыми на элементы.

'''SetParam(s, p, i)''' – заменяет на значение p i-й элемент строки s, разделенной запятыми на элементы.

'''Left(s, i [,full] )''' – возвращает i первых символов строки s. Параметр i, может быть строкой, тогда он считается разделителем и функция, возвращает строку слева от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Mid(s, i, j)''' - возвращает подстроку из s начиная с i символа и длиной j символов

'''Right(s, i [,full])''' – возвращает i последних символов строки s. Параметр i, может быть строкой, тогда он считается разделителем, функция ищет разделитель с конца строки, и возвращает строку справа от разделителя. Параметр full разрешает функции вернуть всю строку s, если по параметру i ничего не нашли, параметр не обязательный, по умолчанию выключен.

'''Reverse(s)''' - возвращает строку s задом-наперед. Полезно например для поиска с конца функций Pos().

'''Char(i)''' – возвращает символ с кодом i.

'''Ord(s)''' – возвращает код первого символа строки s.

'''Replace(s, strFind1, strReplace1, [ strFind2, strReplace2, ... ], [caseInsensetive])''' - возвращает строку s, в которой все включения строк strFind заменены строкой strReplace. Параметры поиска и замены всегда должны быть в паре и их может быть несколько. caseInsensetive - неучитывать регистр, не обязательный параметр, по умолчанию включен.

'''RemSpace(s)''' – возвращает сроку s без начальных и конечных запятых и пробелов, а также начальных точек.

'''SumStr(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''с добавлением валюты'''. Необязательные параметры captions - позволяет изменить название валюты, формат строки может зависеть от текущего языка(посмотреть формат можно в "Справочники"-"Статусы"-"32 Валюты", в разделе "Дополнительная информация"). Language - код языка на котором необходимо вывести сумму прописью. По умолчанию если не обязательные параметры опущены, используются региональные настройки в переменных.

'''NumToStrSimple(f [, captions, language])''' – Возвращает сумму f, написанную прописью, по умолчанию '''без валюты'''. Параметры идентичны функции SUMSTR.

'''FullNameToShort(Name)''' – Возвращает фамилию и инициалы по полному ФИО Name.

'''MonthName1(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в именительном падеже.

'''MonthName2(m)''' – Возвращает имя месяца с номером m с большой буквы на русском языке в родительном падеже.

'''StrForXML(s)''' - Подготавливает строку к парсингу как xml: Если находит в строке подстроку "UTF-8" - перекодирует ее из utf-8 в win-1251, убирает начальный знак вопроса, если такой встречается.

'''FixedIntToStr(i, len[, char])''' - Возвращает целое число i дополненное слева символами char (по-умолчанию - "0") до длины len.

'''Translate(format, [param1, param2, ...])''' - Функция перевода строки format в язык пользователя. Строка format может содержать параметры %s, %d - строка и число соответственно.

'''ExtractFileName(FilePath)''' - возвращает имя файла с расширением из полного пути к файлу FilePath.

====Функции перекодировки====
'''DecodeStr(s, charset)''' - Производит перекодировку строки s в кодировку CP1251. Кодировка строки s должна быть заранее известна и может быть :
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866, UNICODE. Имя кодировки следует передавать в точности без лишних символов.

'''EncodeStr(s, charset)''' - Производит перекодировку строки s в кодировку charset. Кодировка строки s должна быть CP1251, возможны следующие варианты перекодировки:
KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Имя кодировки следует передавать в точности без лишних символов. UNICODE не работает с версии 2021, в ней строки по умолчанию в кодировке unicode.

Функции EncodeBase64(s), DecodeBase64(s), UrlEncode(s), UTF8Encode(s), UTF8Decode(s), Str2UTF(s) - устарели, используйте EncodeStr, DecodeStr.

====Транслитерация====

'''Translit(s)''' - транслитерация строки русского текста s латиницей

'''UnTranslit(s)''' - транслитерация строки s с латиницы на русский.

==== Экранирование ====

'''QUOTEDSTR(s)''' – квотирует строку s символом «\» (обратный слеш). Возвращает строку s, помещенную между символами одинарной кавычки, при этом все вхождения в строку s символов: «\», «"» и «'» экранируются квотирующим символом, а символы #0, #10 и #13 заменяются на \0, \n и \r соответственно.

'''SQLFloat(f)''' – Приводит число с плавающей точкой к виду, пригодному для SQL-запроса, т.е. к тексту с разделителем дробной части – точка.

'''FormatTextXML(s)''' - квотирует строку s для использования в XML. Производит замены спец. символов для корректности XML-синтаксиса.

'''FormatTextJSON(s)''' - переводит строку в формат JSON, экранирует служебные символы.

'''FormatTextBlob(s)''' - строка s содержит файл, функция перекодирует переданную строку в байты, используется для заполнения полей формата blob.

====Хеширование ====

'''HMACHash256(key, text)''' - создаёт хэш по алгоритму SHA256 для проверки целостности сообщения, key - секретный ключ, text - хэшируемое сообщение

'''MD5Hash(text)''' - создаёт хеш по алгоритму MD5

'''SignatureUrl(url)''' - Подписывает переданный URL. Функция возвратит переданный URL с добавленным в конце параметром, в котором будет записана подпись.

=== Функции работы с датой и временем ===

'''CurrTime''' – возвращает текущее время

'''CurrDate''' – возвращает текущую дату

'''CurrMillisecond''' - Возвращает количество миллисекунд прошедших с начала текущего года. Используется для точного расчета временных интервалов.

'''Today''' - возвращает текущую дату в числовом формате.

'''Day(dt)''' – возвращает день месяца даты dt.

'''Month(dt)''' – возвращает месяц года даты dt.

'''Year(dt)''' – возвращает год даты dt.

'''FirstDayOfMonth(dt)''' – Возвращает первый день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( FirstDayOfMonth( CurrDate() ) );
'''Полужирное начертание'''
'''LastDayOfMonth(dt)''' – Возвращает последний день месяца в формате DD.MM.YYYY для даты dt в формате DD.MM.YYYY. Пример вызова: Error( LastDayOfMonth( CurrDate() ) );

'''DaysInMonth(month, year)''' – Возвращает количество дней в указанном месяце.

'''IncDay(dt, [count=1])''' – Возвращает дату, увеличенную на count дней.

'''SQLDate(dt)''' – Пытается конвертировать dt в дату, вернуть в формате «'YYYY-MM-DD'» (с апострофами), если не удается – возвращает «NULL».

'''SQLDateToDate(dt)''' – Переводит дату из SQL-формата в обычный.

'''DAYSBETWEEN(dt1, dt2)''' – Возвращает количество дней между датами dt1 и dt2. В случае ошибки приведения dt1 или dt2 к дате возвращает -1000.

'''TimeBetween(t1, t2)''' - Возвращает количество минут между временем t1 и t2. Если t1 > t2 то будет показано количество минут между t2 и t1. Параметр t может быть как в формате "HH:MM", так и в числовом. Если один из параметров не удалось привести к числовому типу возвращает -1000.

'''WorkDaysBetween(dt1, dt2, [DecreaseFirstDay=0], [DefaultHolidayVarNum=1])''' - Возвращает количество рабочих дней между датами dt1 и dt2. Параметр DecreaseFirstDay уменьшает dt1 на указанное количество дней (по умолчанию 0). В случае ошибки приведения dt1 или dt2 к дате возвращает -1000. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней(по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''TimePeriod(time1, time2)''' - Оформляет временной период. Возвращаемое значение зависит от наличия значения в параметрах. Возможные варианты: "time1 - time2" , "С time1" , "ДО time2".

'''StrDateToFloat(s, [time=false])''' - Переводит строку с датой s в числовой тип. Если параметр time включен, то в строке s должно быть указано время. Дата должна быть в формате "DD.MM.YYYY", а время "HH:NN". Если строку перевести не удалось возвращает 0

'''IsAWorkDay(dt)''' - Когда день dt является рабочим, возвращает true. Если произошла ошибка приведения даты возвращает -1000.

'''IncWorkDay(dt, [count=1],[DefaultHolidayVarNum=1])''' - Прибавляет count рабочих дней к дате dt. Возвращает дату в числовом формате, если произошла ошибка приведения даты возвращает -1000. По умолчанию параметр count равен 1 и не является обязательным. Параметр DefaultHolidayVarNum - использовать для расчета справочник: 1 - выходных дней (по умолчанию); 2 - выходных дней для доставки по городу; 3 - выходных дней для доставки

'''Sleep'''(n) - Задержка выполнения на n миллисекунд.

=== Функции приведения типов ===

'''INT(v)''' – возвращает значение типа “целое”, приводя вариантное значение v к числовому типу, а затем округляя его. В том числе используется как функция округления.

'''FLOAT(v)''' – возвращает значение типа “число”, приводя вариантное значение v к числовому типу, переводя в число цепочку символов до первого нецифрового символа (либо точки или запятой).

'''STR(v)''' – возвращает значение типа “строка”, приводя вариантное значение v к строковому типу.

'''Date(v)''' – возвращает дату, либо пустую строку, если не удается конвертировать v в дату

'''Time(v)''' – возвращает время, либо пустую строку, если не удается конвертировать v во время. Понимает числовое представление времени.

=== Математические функции ===

'''ROUNDUP(f)''' – округляет число f до ближайшего большего по модулю целого числа.

'''ROUNDDN(f)''' – округляет число f до ближайшего меньшего по модулю целого числа.

'''Money(f, CouldBeEmpty, ZeroFill, MakeSpace)''' - Округляет число f, до двух знаков после запятой. CouldBeEmpty - заменить число меньше 0,0001 на пустую строку. ZeroFill - Следить чтобы после запятой было два знака, если будет один, то добавить ноль. MakeSpace - Разделить разряды пробелом.
''Подсказка: для простого округления используется функция int()''

'''Abs(f)''' - возвращает модуль числа f.

'''Mod(x, y)''' - возвращает остаток от деления целочисленного числа x на целочисленное число y.

=== Константы ===

'''Null''' – Возвращает пустое значение.

'''Да''', '''True''', '''Нет''', '''False''' – константы, соответствующие булевым значениям.

=== Прочие функции ===

SetPhoneParams(CountryCode, TownCode) – Устанавливает глобальные настройки кода телефонных кодов страны и города соответственно. По-умолчанию код страны – 7, код города – 495.

PhonesCount(s) – Возвращает количество корректных телефонных номеров, найденных в строке s.

GetPhone(s[, n]) – Возвращает n-й корректный телефонный номер, найденный в строке s. Нумерация начинается с 1.

GetEmail(s) – Возвращает все корректные адреса email, найденный в строке s, разделенные запятыми (т.е. готовыми к передаче в функцию SendEmail).

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject[, FileName]) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

GenEan(ID, Code) – Формирует штрих-код EAN 13 Состоящий из идентификатора типа сущности ID и кода сущности Code, Выравнивает до 13-ти символов, первый – «2», последний – контрольная сума.

CheckEan(s) - Проверяет строку s, что она является кодом EAN13.

SaveToFile(FileName,s, encoding [, append])- Создает текстовый файл по пути, указанному в FileName (если по указанному пути существует файл с указанным именем, он удаляется и создается новый) и производит запись строки s в созданный текстовый файл. encoding - название кодировки, по умолчанию сохраняет в кодировке ANSI. Доступные названия кодировок: KOI8-R, ISO-8859-5, UTF-8, URL, BASE64, QUOTED-PRINTABLE, CP866. Если append = true, то производится дописывание данных в файл, а не перезаписывание (не обязательный, по умолчанию выключен).

StrFromFile(FileName) - Читает файл FileName, возвращает в виде строки. При ошибке чтения вызывает ошибку.

DownloadAttachment(code, [savefilepath, tablename='attachment', fieldBlob='file', fieldLDtime='ldtime', fieldUID='uid']) - Функция выкачивает аттачмент из базы, по внутреннему коду - Code, всегда возвращает содержимое файла в виде строки, а также может сохранить файл по указанному пути в параметре savefilepath. По умолчанию, функция настроена на таблицу attachment. Code - внутренний код вложения, tablename - название таблицы, fieldBlob - название поля с содержимым файла, fieldLDtime - название поля с временем последнего изменения строки (для работы кэша). Функция использует кэш и умеет выкачивать файлы зауженные на внешние серверы (http, ftp,sftp, measoft). Для выкачивания с сервера measoft обязательно необходимо указывать параметр fieldUID.

DeleteFile(FileName) - Удаляет файл FileName с диска, возвращает истину, если операция прошла успешно и ложь - в противном случае.

HTTPPOST(host, PostParams, Proxy, ContentType, HTTPUser, HTTPPass, Method, CustomHeader, Reconnects) - Отправляет HTTP запрос по адресу host с данными PostParams. Proxy - объект Proxy, задающий прокси-сервер (по-умолчанию - пусто - не использовать прокси). ContentType - Заголовок ContentType. По-умолчанию - "application/x-www-form-urlencoded; Charset=UTF-8". HTTPUser и HTTPPass - данные для http-авторизации на сервере. Method - метод отправки запроса, по-умолчанию - "POST". CustomHeader - Дополнительные заголовки HTTP запроса, передается в виде списка параметров через запятую и всегда образуют пару: 1 параметр - название заголовка, 2 параметр - значение. Если значение содержит запятую то его нужно экранировать в двойные кавычки. Reconnects - Количество попыток подключения (по-умолчанию - 2), если больше 100 - это таймаут единственной попытки подключения в миллисекундах.
Функция возвращает ответ сервера. 
''Обратите внимание:'' Для имитации отправки данных html-формы методом POST может понадобиться перед передаваемыми параметрами добавить "Data=".

FTPPUT(host, User, Pass, FileName[, Active]) - Отправляет файл на FTP/SFTP-сервер. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

FTPGET(host, User, Pass, SourceFileName, DestFileName[, Active]) - Загружает файл SourceFileName с FTP/SFTP-сервера, сохраняет его в файл DestFileName. Параметр Host может иметь в себе путь к папке. По-умолчанию работает в пассивном режиме.

GetTempDir - Возвращает путь к временной папке.

ApplicationDir - Возвращает путь к файлу программы.

Interpretate(script) - Интерпретирует скрипт указанный в script. Выполнение происходит в текущем инстансе.

LastHttpError - Выводит последний запрос выполненный с ошибкой в функции HttpPost. Содержит подробную информацию по запросу и ответу.

LastHttpResponse - Выводит последний запрос и ответ от сервера после выполнения Http-запроса в функции HttpPost.

== Объект TExcel ==

Предназначен для доступа к данным документов MS Excel. Требует установленного приложения MS Excel. Для работы без установленного MS Excel предусмотрен объект TDirectExcel.

'''''Ввод данных'''''

LoadFromDB(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Если Headered истинно (по-умолчанию), таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Если TranslateHeader истинно, то заголовки таблицы будут автоматически переведены.

MyDB.Open('select * from kurier');
xl.LoadFromDB(MyDB.Self);
xl.DoNotDestroy(true);
xl.SetVisible(true);

Post2Sheet(DB[, Headered=true][, Col=1][, Row=1][, TranslateHeader=False]) - Почти полный аналог LoadFromDB. В отличии от LoadFromDB если есть открытый файл, выгрузка данных будет выполнена прямо в него.

OpenFile(aFileName) – Выполняет функции SetFileName и Open.

FileName – Возвращает имя текущего файла.

SetFileName(aFileName) – Задает значение свойства FileName.

Open - Открывает файл с именем, заданным свойством FileName. Если имя файла не задано - создает чистую книгу.

Close – Закрывает текущий файл.

'''''Ячейки'''''

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

Cell(x, y, text) – Возвращает значение ячейки, заданной координатами x, y. Необязательный булевый параметр text, в случае истинности, указывает на необходимость возврата данных с учетом формата ячейки, т.е. то, что пользователь видит на экране. Обратите внимание, что если в ячейке число, и ширина столбца не достаточна для отображения, Excel выводит "#####", что и будет возвращено программе, если text=ИСТИНА. Поэтому перед таким использованием рекомендуется выполнить функцию AutoFit.

SetCell(x, y, v[, x2, y2]) – Устанавливает значение ячейки, заданной координатами x и y, в значение v. Если заданы параметры x2, y2 - объединяет (merge) диапазон ячеек заданных координатами, устанавливает значение объединенной ячейки.

'''''Строки'''''

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

RowAutoFit([y1, y2]) - Устанавливает автоматическую высоту строк. Аргументы y1 и y2 необязательны и если не указаны, то процедура будет выполнена для всей страницы, в ином случае только для строк от y1 до y2.

SetRowHeight(r, h[, cnt]) – Устанавливает высоту cnt строк (по-умолчанию 1) начиная со строки r в h пикселей.

GetRowHeight(r) – Возвращает высоту строки r в пикселях.

RowInsert(i[, count]) - Вставляет count (по-умолчанию - 1) строк НАД строкой с номером i.

RowDelete(i[, count]) - Удаляет count (по-умолчанию - 1) строк начиная с номера i.

'''''Столбцы'''''

ColCount - Возвращает количество столбцов в листе.

AutoFit – Устанавливает автоматическую ширину столбцов.

ColumnDelete(i[, count]) - Удаляет count (по-умолчанию - 1) столбцов начиная с номера i.

SetColWidth (c, w) – Устанавливает ширину столбца c в w пикселей.

GetColWidth (c) – Возвращает ширину столбца c в пикселях.

'''''Листы'''''

SetSheet(No) – Устанавливает номер текущего листа. Если лист с таким номером не существует - он будет создан (и все листы до него). Нумерация начинается с 1.

SetSheetName(Name) - Устанавливает название текущего листа.

SheetsCount – Возвращает количество листов в книге.

CopySheetAfter([SheetFrom[, SheetAfter]]) - Копирует лист SheetFrom (по-умолчанию - текущий), создавая новый лист после листа SheetAfter (по-умолчанию - совпадает с копируемым).

SheetDelete(i) - Удаляет лист с номером i.

'''''Форматирование'''''

Align(x1, y1, x2, y2 [,HAlign, VAlign]) - Устанавливает выравнивание данных в указанном диапазоне. HAlign - горизонтальное выравнивание (0 – прижато влево , 1 – по центру , 2 – прижато вправо), VAlign - Вертикальное выравнивание (0 – прижато к верху , 1 – по центру , 2 – прижато к низу).

WrapText(x1, y1, x2, y2, value) – Устанавливает перенос текста прямоугольника в значение value. Если координаты опущены, или 0 – устанавливает границы всей используемой области. Для Value значение по-умолчанию - true.

NumberFormat(x1, y1, x2, y2, Format) - Устанавливает формат вывода чисел в указанном диапазоне ячеек. Например, если Format='0.00' - числа будут выводиться c обязательными 2 знаками после десятичного разделителя.

SetBorders(x1, y1, x2, y2) – Устанавливает границы прямоугольника. Если координаты опущены, или 0 – устанавливает границы всей используемой области.

SetFont(Font[, x1, y1[, x2, y2]]) - Устанавливает шрифт Font для ячеек диапазона. Можно указать координаты только одной ячейки, можно - вообще не указать, тогда будет использован последний выделенный диапазон. Шрифт задается как обычно: 'Arial, 16, T, T, T', порядок параметров: Имя шрифта, размер, жирное начертание, курсивное начертание, одиночное подчеркивание. Если параметры не заданы, то у текущего шрифта они меняться не будут. Примеры: SetFont('Arial, 10, T, F, F', 1,1) - в ячейке A1 будет установлен шрифт Arial жирным начертанием (не курсив и без подчеркивания). SetFont(', , , T, F', 2,1) - в ячейке B1 будет поменяется только начертание курсив и будет отменено подчеркивание (если оно было).

SaveValuesOnly - убирает формулы на текущей странице и оставляет лишь их результативные статичные значения.

'''''Цвета'''''

SetRowFontColor(Row,Color) - Устанавливает цвет шрифта в строке Row. Color - целое значение (RGB)

SetRowColor(Row,Color) - Устанавливает цвет фона в строке Row. Color - целое значение (RGB)

SetColumnFontColor(Col,Color) - Устанавливает цвет шрифта в столбце Col. Color - целое значение (RGB)

SetColumnColor(Col,Color) - Устанавливает цвет фона в столбце Col. Color - целое значение (RGB)

SetCellFontColor(Row,Col,Color) - Устанавливает цвет шрифта в ячейке с координатами [Row,Col]. Color - целое значение, равное номеру цвета в палитре (ColorIndex,не RGB)

SetCellColor(Row,Col,Color) - Устанавливает цвет фона в ячейке с координатами [Row,Col]. Color - целое значение (RGB)

GetRowFontColor(Row)- Возвращает RGB значение цвета шрифта строки Row

GetRowColor(Row)- Возвращает RGB значение цвета фона строки Row

GetColumnFontColor(Col)- Возвращает RGB значение цвета шрифта столбца Col

GetColumnColor(Col)- Возвращает RGB значение цвета фона столбца Col

GetCellFontColor(Row,Col) - Возвращает номер цвета шрифта в палитре (ColorIndex) в ячейке с координатами [Row,Col]

GetCellColor(Row,Col) - Возвращает RGB значение цвета фона в ячейке с координатами [Row,Col]

'''''Копи-паст'''''

Copy(x1, y1, x2, y2) - Копирует в буфер экселя

Cut(x1, y1, x2, y2) - Вырезает в буфер экселя

Paste(x1, y1) - Вставляет из буфера экселя. Команды copy-paste неразрывны, если что нибудь сделать в промежутке между ними, например вставить значение в ячейку, то копирование сброситься. (Последовательность использования: copy - paste, cut - paste)

PasteStyle(x1, x2, y1, y2) - Вставляет только оформление из буфера экселя (Последовательность использования: Copy - PasteStyle)

'''''Изображения'''''

InsertPicture(TPicture, [x=1, y=1, DispX=0, DispY=0, width=0, height=0]) - Функция вставляет рисунок на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки, width, height (не работает для DirectExcel) - ширина и высота области рисунка в пойнтах-единицах Excel

InsertFirmLogo(FirmCode, [x=1, y=1, DispX=0, DispY=0]) - Функция вставляет логотип фирмы с кодом FirmCode на текущий активный лист. x, y - координаты ячейки, относительно которых размещается рисунок, DispX, DispY - смещение рисунка относительно верхнего левого угла этой ячейки.

'''''Вывод'''''

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки. Функция закрывает текущий файл, и не может использоваться для файлов, закрытие которых запрещено.

SheetFitPageWidth - устанавливает режим масштабирования печати, чтобы печатная форма помещалась в ширину на один лист.

SetOrientation(value) - Устанавливает ориентацию страницы. True (по-умолчанию) - альбомная (ландшафтная), Ложь - портретная.

PrintOut([copies]) - Печатает текущий лист на принтере по умолчанию. Параметр copies - количество копий, по умолчанию равен 1.

Save(filename) - Сохраняет в файл filename. Если файл существует, в основной системе он будет перезаписан, в других проектах - вызовет ошибку "Файл уже существует".

SetVisible(b) – Устанавливает видимость приложения Excel для пользователя. По-умолчанию – false (не видимо).

DoNotDestroy(b) – При уничтожении объекта TExcel (а он уничтожается, как и все остальные объекты автоматически при завершении выполнения скрипта), приложение Excel уничтожается вместе с ним. DoNotDestroy(true) отключает уничтожение приложения.

'''''Пример использования'''''

new('TExcel', 'myxl');
myxl.OpenFile('c:\asdf.xlsx');
set($sum, 0);
while (myxl.EOF=0,
set($sum, $sum+int(myxl.c));
myxl.next );
$sum

''Возвращает сумму всех числовых данных столбца C файла 'c:\asdf.xlsx'''

== Объект TDirectExcel ==
Объект позволяет работать с файлами Excel напрямую, без установленного пакета MsOffice. Применяется в сервисах и при отсутствии экселя. Он максимально совместим с объектом TExcel, однако некоторые методы могут быть не реализованы.

== Объект TCSVFile ==
Предназначен для доступа к данным документов CSV. Разделителем столбцов является символ точка с запятой ;

Функции:

FileName – Возвращает имя текущего файла.

OpenFile(FileName) – Открывает файл FileName.

LoadFromDB(DB[, Headered=false]) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO.

LoadFromText(s) - Загружает таблицу из строки s.

RecNo – Возвращает номер текущей строки. Нумерация строк начинается с 1.

SetRecNo(aRecNo) – Устанавливает значение свойства RecNo.

A..ZZ – Возвращает значение соответствующего поля текущей строки. Может вызываться с целочисленным аргументом, указывающим на сдвиг относительно текущей строки. Например: AC(-1) – вернет значение столбца AC предыдущей строки. Если номер строки окажется вне допустимых значений вернет пустую строку.

First – Делает первую запись листа текущей.

Next – Увеличивает значение свойства RecNo на единицу в случае, если конец файла не достигнут. Иначе – выставляет свойство EOF в истину.

EOF – Возвращает признак достижения конца файла.

RecordCount – Возвращает количество строк в листе.

SendEmail(Server, Port, User, Pass, AddressFrom, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY).

SendEmail(EmailFromStr, AddressTo, MsgText, Subject) – Отправляет письмо по e-mail с указанными параметрами. В случае ошибки отправки вызывает ошибку (рекомендуется использовать совместно с TRY). EmailFromStr – строка, содержащая данные для отправки письма – адрес SMTP-сервера, порт, логин, пароль и email отправителя, разделенные символом переноса строки.

SaveToFile(Filename) - Сохраняет в файл с именем filename.

== Объект TADO ==

Предназначен для доступа к базам данных.

Функции:
{| class="wikitable"
!Функция
!Описание
|-
|Connect(ConnectionString)
|Подключает к источнику данных. ConnectionString – Строка подключения ADO.
|-
|ConnectMySQL(DBServer, DBPort, DBUser, DBPass, DBName)
|Подключает к базе данных MySQL.
|-
|Open(Query)
|Открывает набор данных выполнив запрос Query.
|-
|FieldByNo(i)
|Возвращает значение поля с номером i. Нумерация полей – с нуля.
|-
|FieldName(i)
|Возвращает имя поля с номером i.
|-
|FieldCount
|Возвращает количество полей.
|-
|RecordCount
|Возвращает количество записей.
|-
|RecNo
|Возвращает номер текущей записи. ''ВНИМАНИЕ! В зависимости от способа подключения к БД нумерация может начинаться как с 0 так и с 1!''
|-
|EOF
|Возвращает признак достижения конца набора данных. Становится истиной когда выполняется команда Next на последней записи.
|-
|Next
|Переход на следующую запись набора.
|-
|First
|Переход на первую запись набора.
|-
|Last
|Переход на последнюю запись набора.
|-
|FieldByName(FieldName)
|Возвращает значение поля по имени. Также возможно указание имени поля как свойства объекта.
|-
|Field(Table, ID, FieldName)
|Возвращает значение поля FieldName записи с кодом ID таблицы Table. Набор данных, если он открыт, при этом не закрывается. Первичный ключ таблицы должен называться «code». Гарантированно работает только с MYSQL!!!
|-
|GetSQLValue(Query)
|Выполняет SQL-запрос. Текст запроса должен начинаться с первого символа строки (перед запросом не должно быть пробелов, переносов строк, комментариев и т.д.). Если запрос Insert – возвращает ID вставленной записи. Если запрос – Update, Delete, Replace, Set, Start, Commit, Rollback – возвращает количество измененных записей (RowsAffected), иначе – Select – значение первого поля первой строки результата как текст.
|-
|FillText(s)
|Возвращает строку s с замененными названиями полей между знаками процента на соответствующие значения текущей записи. Так же в строке возможно использование интерпретируемого кода, заключенного между тегами "<?>" и ">". При интерпретации система сначала производит замену полей с процентами на значения, потом интерпретирует код. ''Внимание! Функция не создает отельный контекст интерпретатора, а использует существующий, в нем доступны все объекты и переменные, вызывающего скрипта.'' Дополнительно автоматически создается объект TSelfADO, подключенный к той же БД, что и контекст, вызвавший функцию, с пустым именем, а так же с именем "dataset".
|-
|Query(Query)
|Синоним GetSQLValue.
|-
|Close
|Закрывает набор данных.
|-
|Self
|Возвращает указатель на подключение к БД для использования в других объектах.
|-
|ParseForIn([FieldName='code'])
|Возвращает через запятую значения всех строк в указанном столбце. По умолчанию, используется столбец с именем code.
|-
|GetSQL
|Для отладки. Возвращает последний SQL запрос переданный в методы Open, Query, GetSQLValue
|-
|ExportExcel
|Для отладки. Выгружает в эксель содержимое датасета. Можно использовать в незнакомом окружении для понимания передаваемых полей в : шаблонах, печатных формах и т.д. Аналог команды %echo% в шаблонах, на случай если она не сработает.
|-
|OnGetText
|Функция подменяет текстовый вывод значения поля при выгрузке в эксель. Первый параметр это имя поля, которое надо подменить. Второй параметр это то что необходимо вывести. Работает только с текстовыми полями.
'''''Пример использования'''''
DB.OnGetText('Зона', IF((DB.FieldByName('-Lat') ! 0) * (DB.FieldByName('-Lon') ! 0),
GetPolygonByLatLon(DB.FieldByName('-Lat'), DB.FieldByName('-Lon'), 'TYPE = 1 AND IFNULL(zone, 0) > 0 AND PRICE = ' + DB.FieldByName('-price'), 'zone')
,
''
));
|}

Пример использования – см. TSelfADO

== Объект TSelfADO ==

Наследник объекта TADO. Служит для подключения к «родной» для программы, в которой выполняется скрипт, базе данных. Обладает всеми свойствами и методами объекта TADO, кроме Connect. Иногда автоматически создается системой для обеспечения простого доступа к базе данных, а также иногда создается системой с уже открытым набором данных для передачи обрабатываемого системой набора данных в скрипт. В этом случае для скрипта недоступны функции Open и Close.

Пример использования:

rem('Копируем данные из "родной" базы данных в базу MSSQL.');
new('TSelfADO', 'MyDB');
new('TADO', 'MSSQL');
MSSQL.Connect('Provider=SQLOLEDB.1;Password=myPassword;Persist Security Info=True;User ID=myUsername;Initial Catalog=myDataBase;Data Source=myServerAddress');
MyDB.Open('select code, name, passport from kurier where code>'+Int(MSSQL.Query('select max(code) from kurier'))+' order by code');
While(MyDB.EOF=0,
MSSQL.Query('insert kurier (code, name, passport) VALUES ('+MyDB.Code+', '+QuotedStr(MyDB.Name)+', '+QuotedStr(MyDB.Passport)+')');
MyDB.Next;
);

== Объект TPrinter ==

Предназначен для доступа к принтерам.

Функции:

BeginDoc – Начинает новый документ.

EndDoc – Закрывает документ

PageHeight – Возвращает высоту страницы в пикселях

PageWidth – Возвращает ширину страницы в пикселях

PageNumber – Возвращает номер текущей страницы документа

Orientation – Возвращает текущую ориентацию страницы (0 – портретная, 1 – ландшафтная)

Printing – Возвращает истину если документ открыт

SetOrientation(Orientation) – Устанавливает ориентацию страницы. При необходимости начинает новый документ, новую страницу.

ShowDialog – Показывает пользовательский диалог печати. Возвращает истину, если пользователь нажал "OK".

NewPage – Начинает новую страницу

Canvas – Предоставляет доступ к объекту TCanvas, связанному с принтером.

PrinterNames – Возвращает список принтеров, установленных в системе, разделенный переносами строк

PrintersCount – Возвращает количество установленных в системе принтеров

SetPrinter(Printer) – Устанавливает текущий принтер. Если передана строка – ищет принтер по названию, иначе – по номеру. Нумерация начинается с 0.

PrintTable(Y, Table) – Выводит на печать таблицу Table типа TTable, начиная с координаты Y. При необходимости таблица печатается на нескольких страницах. Возвращает координату Y конца таблицы.

GetDefaultPrinter - Возвращает имя текущего активного принтера.

SetDefaultPrinter(Printer) – Запоминает предыдущий активный принтер и устанавливает новый текущий принтер. Printer - имя принтера. При необходимости нескольких последовательных вызовов SetDefaultPrinter рекомендуется между вызовами использовать RestoreDefaultPrinter.

RestoreDefaultPrinter - Устанавливает активным принтер, который был текущим перед последним вызовом SetDefaultPrinter.

== Объект TCanvas ==

Предоставляет доступ к холсту объекта для прорисовки изображения.

Функции:

DPIX – Возвращает разрешение холста по горизонтали в точках на дюйм

DPIY – Возвращает разрешение холста по вертикали в точках на дюйм

TextOut(x, y, s[, x1, y1, x2, y2]) – Выводит строку s начиная с точки с координатами x и y. Если указаны параметры x1, y1, x2, y2 – то выводимый текст ограничивается заданным прямоугольником.

TextOutEx(x1, y1, x2, y2, Alignment, Font, s, Indent) – Выводит строку s в прямоугольнике с координатами x1, y1, x2, y2. По горизонтали строка выравнивается в соответствии с Alignment (0 – прижато влево, 1 – вправо, 2 – по центру), по вертикали выравнивается по центру. Используя шрифт Font (см описание ниже). Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату X фактического окончания текста (правой стороны – если строка прижата влево, и левой – в остальных случаях)

MLTextOut(x1, y1, x2, y2, Alignment, VAlignment, Font, s, Heigth, Indent) – Выводит многострочный текст s в прямоугольнике с координатами x1, y1, x2, y2 с переносом по словам. По горизонтали строки выравниваются в соответствии с Alignment, по вертикали – в соответствии с VAlignment (0 – прижато вверх, 1 – по центру, 2 – прижато вниз). Используя шрифт Font (см описание ниже). Heigth – высота строки. Если опущено или равно нулю – высота определяется автоматически в соответствии с выбранным шрифтом. Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату Y фактического окончания текста (нижней границы последней строки текста. ''ВНИМАНИЕ! Функция использует координаты прямоугольника для позиционирования текста, однако она не ограничивает его верхней и нижней границами этого прямоугольника!''

DrawPic(x1, y1, x2, y2, Pic, Style, Alignment, Mode) – Прорисовывает изображение Pic (ссылка на изображение TPicture.Self) в прямоугольник заданный координатами x1-y2. Style – стиль масштабирования. 0 – растянуть изображение до границ прямоугольника не сохраняя пропорции, 1 – вписать изображение в прямоугольник сохраняя пропорции – вероятно, останутся поля по вертикали или горизонтали, 2 – вписать сохраняя пропорции, обрезав при необходимости изображение по вертикали или горизонтали. Alignment – выравнивание по горизонтали. Работает только в случае если style=1 и при растягивании изображения получились вертикальные поля. 0 – разместить по центру, 1 – прижать влево, 2 – прижать вправо. Функция возвращает координату X правой стороны изображения кроме случая, когда Style=1 и Alignment=2 – в этом случае возвращается координата левой стороны изображения. Mode - способ наложения изображения. 0 (по-умолчанию) - копирование как есть. 1 - Наложение операцией AND (применяется для получения эффекта прозрачности изображения), 2 - наложение операцией XOR (Применяется для возможности повторной операцией убрать изображение), 3 - Наложение операцией OR.

FillRect(x1, y1, x2, y2) – Рисует прямоугольник '''без границ''' и закрашивает цветом BrashColor

Rect(x1, y1, x2, y2) – Рисует прямоугольник '''c границами''', задаваемыми текущим пером, и закрашивает цветом BrashColor

SetFont(Font) – Устанавливает шрифт по-умолчанию.

SetPen(Width, Color) - Устанавливает параметры "ручки" - толщину и цвет. Если любой параметр опустить, соответствующее значение не будет изменено.

SetBrush(Color, Style) - Устанавливает параметры заливки - цвет и стиль. Если любой параметр опустить, соответствующее значение не будет изменено. Стили заливки: 0 - сплошная, 1 - отсутствует (прозрачная), 2-7 - различные виды штриховки (горизонтальные, вертикальные, в клеточку и т.д.).

TextHeight(s) – Возвращает высоту текста s в пикселях без учета многострочности, с учетом текущего шрифта.

TextWidth(s) – Возвращает ширину текста s в пикселях без учета многострочности, с учетом текущего шрифта.

Использование шрифта (Font): У объекта TCanvas есть «глобальные» установки шрифта. Однако для некоторых функций возможно указание шрифта, отличающегося от глобального. Параметры шрифта – это текстовая строка, состоящая из 6-ти параметров, разделенных запятыми: Название, размер, жирный, курсив, подчеркнутый, цвет. Например:

'Times New Roman, 8, Y, N, N, 255'

Любой параметр можно опустить, и тогда вместо него будет использовано значение по-умолчанию: шрифт: arial, размер – 10, не жирный, не курсив, не подчеркнутый, цвет – черный. Например: ', 7' – указывает, что по-умолчанию нужно взять все параметры кроме размера шрифта. Также можно вместо всей строки указать тире ('-') или пустую строку, и шрифт будет использоваться «глобальный».

Объект можно создать отдельно, не создавая объект TPrinter. В таком случае объект создастся как ссылка на текущий холст принтера (принтер должен быть запущен и начат новый документ). Такой подход используется в доп. возможности PrintCustomSticker

== Объект TPicture ==

Предоставляет функции для работы с графическими изображениями форматов BMP, GIF, JPEG и PNG, а также для формирования штрих-кодов. Обратите внимание, прозрачность изображений не поддерживается, однако в методе TCanvas.DrawPic есть параметр Mode, призванный создавать эффект прозрачности.

Функции:

LoadFromFile(FileName) – Загружает изображение из файла FileName. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromDB(DB, Query) – Загружает изображение из базы данных. DB – ссылка на подключение к базе данных TADO.Self, Query – текст запроса. Запрос должен вернуть в первом поле первой строки BLOB-поле с изображением, все остальные данные возвращаемые запросом игнорируются. Возвращает истину, если операция прошла успешно, иначе – ложь.

LoadFromStr($s) – Загружает изображение из строки $s. Возвращает истину, если операция прошла успешно, иначе – ложь.

CreateBar(Width, Height, BarCode, Textless, Type) – Формирует штрих-код шириной Width и высотой Height с типом кодирования Type. BarCode – текст штрих-кода. Булево значение Textless указывает, что в штрих-коде не должно быть человеко-читаемых символов если истинно. Type указывает тип кодирования: 0 (по-умолчанию) CODE128, 1 - EAN-13, 2 - Interleaved 2-5, 3-DataMatrix, 4-QRCode.
Штрихкод должен быть: Для EAN-13 цифровым 12 или 13 символов (13-й, контрольная сумма рассчитывается автоматически), для CODE128 - должен иметь состоять из допустимого для этого кодирования набора символов. Для Interleaved - должен состоять из четного числа цифр, контрольная сумма автоматически не рассчитывается. Если для Interleaved кода указано значение из 14-ти знаков, подпись цифр выводится в формате Почты России.
Внимание! Для кодов EAN-13 и Interleaved ширина штрих-кода Width не является точным значением получаемого на выходе изображения. Ширина изображения рассчитывается как максимальное кратное минимально возможной ширине, но не меньше минимально возможной. Конечную ширину можно получить в соответствующем свойстве объекта. Для кода CODE128 штрих-код на выходе может оказаться пустым, если указанной ширины штрих-кода не достаточно для его формирования.
Для кода DataMatrix можно установить режим для печати скрытых символов с кодами 29(GS) и 232(FCN1), которые требуются для формирования Честного Знака. Для этого необходимо в начале строки указать символ "[" и все разделители 01, 21, 91, 92 так же экранировать этими скобками. Должно получиться [01]02900002317701[21]k3LInNbH_oG0Q[91]EE06[92]YXiyKfiHjE4YE8b+YVMC1O5r8VtpplA3AwcCqrcG9Dk= . При формировании кода, включится режим формирования штрих-кода DataMatrix GS1, в начале будет добавлен символ с кодом 232 (FCN1), а потом будут добавлены разделители с кодом 29 (GS)
Функция возвращает 1 в случае успеха, или текст ошибки, если такая произошла.

SetSize(Width, Height) - Устанавливает размер изображения.

AsString([ImageFormat]) - Возвращает изображение в виде строки с двоичными данными. ImageFormat принимает значения 1 - Bitmap (по-умолчанию), 2 - jpeg, 3 - png, 4 - gif.

Width – Возвращает ширину изображения.

Height – Возвращает высоту изображения.

Rotate(Angle) – Поворачивает изображение по часовой стрелке на угол Angle. Угол указывается в градусах и может принимать любые значения.

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

Canvas - ссылка на объект TCanvas холста изображения.

== Объект TTable ==

Предоставляет функции для работы с таблицами. Удобен для печати таблицы на принтере. Алгоритм таков: Загружаем датасет в таблицу, настраиваем ее (шрифты, штрих-коды и т.д.), потом выводим на принтер функцией TPrinter.PrintTable.

Функции:

LoadFromDB(DB) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». В одной таблице допускается не более одного поля с порядковой нумерацией. Поля, названия которых начинаются в символа "-" не выгружаются. Заголовок – это первая строка таблицы.

Cell(С, R) – Возвращает значение ячейки таблицы с координатами (C, R). Нумерация строк и столбцов начинается с 1.

SetCell(С, R, Value) – Устанавливает значение ячейки таблицы с координатами (C, R) в Value. Нумерация строк и столбцов начинается с 1.

RowCount – Возвращает количество строк в таблице.

ColCount – Возвращает количество столбцов в таблице.

SetTitleFont(Font) – Задает шрифт заголовка таблицы (первой строки).

SetFont(Font) – Задает шрифт всей таблицы кроме заголовка.

SetColFont(C, Font) - Устанавливает шрифт столбца C.

SetIndent(Indent) – Задает отступ от границы ячейки до текста в процентах от ширины страницы. По-умолчанию значение 0.3

SetWidth(С, Width) – Задает значение ширины столбца C в процентах от ширины страницы.

SetMinRowHeght (Heght) – Задает значение минимальной высоты строки в пикселях.

SetBarCode(Col, Type) - Указывает, что данные из столбца Col должны печататься в виде штрих-кода. Тип штрих-кода - Type. Значение '''"1" - EAN13'''. Для кода EAN13 первая строка данных в ячейке должна иметь вид "тип штрих-кода, номер", например "7, 123" (без кавычек, конечно). В этом случае система сформирует штрих-код: "2700000001233". Первая цифра - всегда 2, далее - указанный тип штрих-кода, нули, чтобы получилось 13 символов, номер, указанный в таблице, и один символ - контрольная сумма. Значение '''"2" - CODE128''' (с версии 734). Данные из первой строки ячейки таблицы печатаются в штрих-коде "как есть". Для всех видов штрих-кода (с версии 734) последующие строки печатаются под штрих-кодом в виде текста.

SetMultiHeader(Active) - Включает печать заголовка при переносе таблицы на несколько страниц. По умолчанию отключено.

SetCustomHeader(script) - Включает печать пользовательского заголовка. Script - это код интерпретатора, который должен печатать заголовок на канву. Печать таблицы может происходить на нескольких листах, по этому скрипт будет вызван для каждого листа. При использовании этого метода, автоматически инициализируются переменные: $TablePageNo - номер страницы, нумерация начинается с нуля; $TableY - координата по оси Y, от которой рисуется заголовок. Чтобы таблица была под заголовком необходимо значение переменной $TableY увеличить на высоту заголовка.

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

Пример:
<?>
NEW('TPrinter', 'Prn');
If(prn.ShowDialog,
NEW('TTable', 'Tbl');
NEW('TSelfADO', 'MyDB');
MyDB.Open('SELECT concat("7", ", ", a.code, "\r\n", a.client_id, "\r\n", a.zakaz, "-", a.number) as "Штрих-код", a.target AS "Заказик", address, phone, vlog, poruch FROM address a order by code desc limit 10');
Tbl.LoadFromDB(MyDB.Self);
Tbl.SetBarcode(1, 1);
Tbl.SetCustomHeader(
if($TablePageNo>0,
Prn.Canvas.TextOut(Prn.Canvas.DPIX*0.1, $TableY, 'Продолжение таблицы');
set($TableY, $TableY + Prn.Canvas.TextHeight('H'));
,0)
);
Prn.BeginDoc;
Prn.PrintTable(0, Tbl.Self);
Prn.EndDoc
, );

== Объект TBaseUtils ==

Предоставляет функции, базирующиеся на БД системы «MEASOFT». По-умолчанию, при создании подключается к основной базе данных модуля, в котором выполняется скрипт, если такая определена контекстом, однако это можно изменить, см SetConnection.

Функции:

'''MakeAddress(s[,town])''' – возвращает значение, полученное путем преобразований адреса s для приведения его к внутреннему формату программы. В процессе преобразования до нескольких раз происходит замена буквосочетаний по таблице замены (ее редактирование доступно по нажатию кнопки «Автозамена» в интерфейсе импорта БД из Excel системы (см. Руководство пользователя)), поиск улиц по базе КЛАДР с точностью до одного знака, и некоторые другие операции, нацеленные на исправление ошибок в написании адреса.

С версии программы 2008.0.0.615, при вызове функции в формулах загрузки реестра, в первую очередь происходит проверка строки s на условия:
* в строке s записано число;
* строка s начинается с "ПВЗ ".
Если одно из этих условий выполняется, то функция пытается установить пункт самовывоза - т.е она сама в загружаемой карточке корреспонденции укажет: адрес ПВЗ, город ПВЗ и установит галку самовывоз. Правила поиска ПВЗ:
* Если s число - считаем его внутренним кодом филиала;
* Если s начинается с "ПВЗ " - Например в адресе передана строка "ПВЗ На Ленинском проспекте", то искать будем филиал с названием "На Ленинском проспекте" который подчиненный, активный, с галкой ПВЗ и в городе town. Если город не указан, то ищем филиал во всех городах, и считаем его найденным если найдем только один филиал.
* Если филиалы найти не удалось, функция makeaddress работает как обычно и выполняет преобразование адреса.

Если адрес не содержит русских букв, только латиница, и курьерская служба находится в одной из стран Россия, Белоруссия, Казахстан или Украина, и город-получатель (второй параметр, town) находится так же в одной из этих стран, функция автоматически делает транслитерацию адреса на русский язык.

''SetConnection(DB) – Подключает объект к базе данных DB, где DB – ссылка на объект TADO.Self.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

''SetTown(Town) – Устанавливает код текущего города (используется в некоторых функциях объекта) в значение Town. По-умолчанию текущий город – 1.'' '''ВРЕМЕННО НЕ РАБОТАЕТ!'''

'''SetIndexLength(Length)''' – Устанавливает длину почтового индекса. По-умолчанию – 6.

'''GetIndex(Address)''' – Возвращает почтовый индекс из адреса.

'''GetStreet(Address)''' - Возвращает улицу до первой запятой.

'''GetHome(Address)''' - Возвращает номер дома до второй запятой, но не более пяти символов.

'''GetKurierByStation(station, Mass, Cash, Date_Putn)'''

'''TownByIndex(Index[, PriorityName][, PriorityCountry])''' – Возвращает код города по индексу. В случае ошибки поиска – код текущего города. Если нашлось несколько населенных пунктов, и указано приоритетное название - выбирается населенный пункт, название которого начинается с PriorityName (если есть).

'''TownByName(Name[,NotNeedCL=False, City=0])''' – Возвращает код города по имени. В случае ошибки поиска – возвратит код текущего города. Если параметр NotNeedCL (параметр не обязательный) установить в TRUE, тогда функция возвратит 0, если город не удалось найти. Параметр City (код региона) позволяет ограничить поиск одной областью (не обязательный, по умолчанию не используется).

'''FillClientInfo(Excel, client, Sheet, Row, Col)''' – Выводит в эксель информацию о клиенте с кодом client на лист sheet начиная со строки row и столбца col.

'''SavePrintFormToFile(FormType, FormNumber)''' - Сохраняет на диске файл печатной формы и возвращает путь к нему

'''CreateTrans(Address[, Store][, Operator][,Correction])''' - Формирует запись для печати кассового чека для корреспонденции с кодом Address, для выбора кассового аппарата используется код склада Store. Если Store не указано - при исполнении в среде клиентского модуля системы использует склад, указанный пользователем в окне [[Настройка параметров рабочего места|"Настройка" - "Параметры"]], в остальных модулях - код текущего склада из [[Настройка глобальных параметров|переменной]] "CL" ("Текущий филиал"). Поле Operator позволяет указать кассира (передается код справочника сотрудников). Если не указан, в основной системе будет использован код авторизованного пользователя, в других модулях - 1.
Поле Correction позволяет указать данные для корректировочного чека, используется в системе Штрих-М. По умолчанию пустая строка. Возвращает идентификаторы записей чеков. Может вернуть пустую строку, если чек создавать не понадобилось, один или несколько кодов через запятую, если создано несколько чеков. В случае ошибки вызывает ошибку, поэтому рекомендуется использовать с функцией Try.

'''CreateReturnTrans(Address)''' - формирует запись для печати чека возврата для корреспонденции с кодом Address. Чек возврата печатается на полную сумму и с теми же атрибутами, что и чек продажи. Возвращает идентификатор записи чека возврата. В случае ошибки вызывает ошибку, поэтому, как и с CreateTrans, рекомендуется использовать с функцией Try.

'''CalcTownDeliveryDays(Source, Mode, TownTo, TownFrom)''' - возвращает количество дней необходимых на доставку отправления, только для межгорода. Source - код клиента, Mode - режим срочности, TownFrom - код города отправителя, TownTo - код города получателя.

'''CalcDeliveryDate(Source, Mode, TownTo, TownFrom, Date_Beg, Time_beg)''' - Возвращает планируемую дату доставки с учетом сроков доставки. Работает при городской и междугородней доставке. Для межгорода сроки доставки берутся из зон. Для городской доставки, из дополнительных параметров статуса (17 статус, 1 параметр в доп. информации) Если рассчитать дату планируемой доставки не удалось, возвращает пустую строку. Параметры: Source - код клиента, Mode - режим срочности, TownTo - город получатель, TownFrom - город отправитель, date_beg - дата заказа (может быть передана строкой в формате DD.MM.YYYY или в числовом), time_beg - время заказа.

'''GenSpecialSMA(DirectExcel, Code)''' - функция для генерации отчета о доставке по акту передачи денег. Первый параметр - указатель на TDirectExcel, второй параметр - код акта передачи денег. АПД выводится на текущий лист объекта TDirectExcel.

'''CreateSpecialSMA(ClientCode, DateTo)''' - Функция создает исходящий акт передачи денег (АПД). Требует ClientCode - код клиента, DateTo - дату акта. Функция возвращает коды созданных актов. Если возвращаемых параметров два, значит функция пыталась создать два АПД: первым, идет код АПД с наличной оплатой, а вторым с безналичной. Примеры возвращаемого результата: '0'- акт не был создан, отсутствуют корреспонденции; '124' - код созданного акта; '0,0' - пытались создать два акта, но отсутствуют данные; '4556,0' - создан только наличный АПД; '0,445' - создан только безнал.; '4556,445' - созданы нал. и безнал.

'''CreateAddressForActDelivery(ActCode, [DeliveryDateMode=0, Delivery=True])''' - Функция создает корреспонденцию на доставку акта. ActCode - код акта; DeliveryDateMode: 0 - установить план. дату доставки текущим рабочим днем, 1 - установить план. дату доставки следующим рабочим днем, 2 - установить план. дату доставки равной планируемой дате оплаты АПД; Delivery - создать корр. на доставку АПД или создать корреспонденцию на забор АПД (по умолчанию, доставка АПД). Работа функции может быть изменена системной доп. возможностью OnCreateAddressForActDelivery.

'''CreateAddressTransferAct(ClientCode, Store, DateTo, [AdditionalParam])''' - Функция создает исходящий акт передачи корреспонденции (АПК). Требует ClientCode - код клиента, Store - код филиала, для которого будет создан акт, DateTo - дату, до которой в акт попадут возвраты, AdditionalParam - дополнительный строковый параметр для передачи в системную доп. возможность ExceptionsForAPK, позволяющий отобрать в акт, например, только полные возвраты. Возвращает код созданного акта. ВНИМАНИЕ: при создании АПК используется системная функция ExceptionsForAPK. Если в ней используются интерактивные функции (вывод сообщений, диалоговые окна, выполнение скриптов), то акт сформирован не будет, а функция CREATEADDRESSTRANSFERACT вернет ошибку.

'''GetPolygonByAddress(Address, TownCode, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попал адрес. Если полигон найти не удалось, функция возвратит пустую строку. Address - адрес корреспонденции текстом; TownCode - код города; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByAddress(addressrecord.address, if((addressrecord.number=0)*(addressrecord.strbarcode=<nowiki>''</nowiki>), addressrecord.townfrom, addressrecord.townto), '`schema`=1') - пытаемся найти вхождение адреса в полигоны 1 схемы, при выборе города учитывается корр. на забор, у нее нужно использовать город-отправитель (а для обычной корр. нужен город-получатель).

'''GetPolygonByLatLon(Lat, Lon, where[, field='code'])''' - функция возвращает значение связанное с полигоном в который попали GPS координаты. Если полигон найти не удалось, функция возвратит пустую строку. Lat - широта текстом; Lon - долгота текстом; where - SQL условие; field - необязательный параметр, определяет возвращаемое значение при найденном полигоне, по умолчанию равен "code".

Пример:
GetPolygonByLatLon('55.769064','37.590713','zone is not null and price=0') - пытаемся найти вхождение координат в полигоны, где задана зона, для всех клиентских и курьерских зон.

'''GetLatLonByAddress(AddressText, TownCode)''' - возвращает географические координаты вида lat,lon указанного в AddressText адреса. Поиск производится в городе, имеющем код TownCode в таблице Town.

'''GetRouteCode(AddressText, TownCode, LatLon[, Lon])''' - для адреса AddressText в городе с кодом TownCode (из таблицы Town) по географическим координатам lat, lon возвращает код роута (записи, хранящей координаты адреса в городе). Если роут не найден (для адреса в городе не найдено записи с указанными координатами) - создает новый роут и возвращает его код, если роут найден (был создан ранее) - обновляет у роута координаты. Если параметр Lon задан, то параметр LatLon должен содержать одну координату, иначе LatLon должен содержать строку вида 'lat, lon'.
В случае ошибки возвращает Null.

Пример: 
Set($res, GetRouteCode(address, townto, '55.114034, 36.592397')); 
Set($res, GetRouteCode('Троицк, Полковника милиции Курочкина ул., 11', 1, '37.467446, 55.740537')); 
Set($res, GetRouteCode('Обнинск, Маркса пр., 20', TownByName('Обнинск'), 55.114034, 36.592397));

'''CalcAgentPrice(AddressCode, AgentCode, TownFrom, TownTo, Mode, [, Count=1])''' - функция возвращает стоимость доставки рассчитанную по тарифу агента. AddressCode - код адреса, AgenCode - код филиала (агента), TownFrom - код города отправителя, TownTo - код города получателя, Mode - режим срочности, count - тарифная сетку от указанного количества отправлений (по умолчанию 1)

'''SetAddrKol_vo(address, getkol_vo)''' - функция делает прием корреспонденции в текущем ответственном филиале. address - внутренний код адреса, getkol_vo - количество принимаемых мест, может принимать значения: "kol_vo" - принять все места, "getKol_vo+1" - принять еще одно место, "число" - сделать количество принятых мест равным указанному числу.

'''CalcClientCnt(client_code, date, is_intown [, date_put=CurrDate(), skipajust=false])''' - функция расчета количество доставленных корреспонденций у клиента с кодом client_code за предыдущий месяц от даты date (Или за текущий месяц, подробнее смотри переменную UseCurrentMonthCount) среди внутригородских (is_intown = true) либо междугородних (is_intown = false) корреспонденций, date_put - дата доставки (для альтернативного способа подсчета, включаемого переменной UseDatePutForCalcCnt), skipajust - не учитывать принудительно введенные количества (таблица priceclientadjust типы записей 0 и 1).

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset._self".
Описание некоторых полей датасета:
pmoney - процент от суммы;
pmoneycard - процент от суммы при оплате картой;
pricecode - код прайса (таблица Price) ;
distarea - район метро получателя (актуально при отключённом едином районировании, как правило район от 200 до 299 является признаком области);
region - признак области при включенном едином районировании;
distareaFrom и regionFrom - аналог distarea, region только для отправителя;
pcncode - код записи таблицы pricecnt "количество от";
Запрос содержит поля таблицы pricelinesnew - начальная стоимость по тарифной сетки, найденные без учета массы,только по типу срочности и режиму.
Запрос содержит поля таблицы price.

*addressrecord - ссылка на объектную модель карточки корреспонденции, следует использовать уже созданную addressrecord._self
*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*type - тип корреспонденции;
*mode - режим доставки;
*wait - количество минут ожидания (не учитывается при доп. услугах, есть системная услуга "ожидание");
*mass - масса отправления;
*rur - сумма передаваемых денег (не учитывается при доп. услугах, есть системная услуга "процент от суммы");
*inshprice - сумма страховки (не учитывается при доп. услугах, есть системная услуга "процент от объявленной стоимости");
*distance - расстояние до места доставки, обычно поле заполняется при доставке в область (регион в едино районировании). Дополнительная наценка к стоимости доставки;
*forward - направление доставки: true - туда; false - обратно;
*Collection - признак заборной корреспонденции: true - забор, false - доставка (В тарифе есть возможность указать стоимость для забора);
*TownFrom - код города отправителя;
*TownTo - код города получателя.

В тарифе есть возможность указать формулу, которая может влиять на базовый расчет. Формула может объявить служебные переменные, которые:
*$FormulaReplace - если true – возвращаемое значение полностью заменяет базовый расчет;
*$FormulaKoeff - коэффициент на который будет помножена базовая стоимость.
Также внутри формулы объявлены следующие объекты dataset, addressrecord и переменные:
*$ForceIntown - Переменная становится истиной, если междугородний расчет был отменен, т.к. адрес попал в нарисованную зону на карте.
*а также: $forward, $distance, $Count, $Collection, $Wait, $FormulaKoeff, $PriceCode - описание есть выше.

Для направления "туда", Функция GetBasePrice вызывается через доп. услугу "База" (при включенных доп. услугах), для направления "Обратно" всегда вызывается напрямую (т.к. доп. услуги работают только в для направления "туда").
На расчет этой функции влияют следующие переменные: "Финансы" -> "Расчет стоимости по адресу", "Финансы" -> "Зона клиента по умолчанию", "Финансы" -> "Подсчет кол-ва отправлений за месяц".

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

*ds - ссылка на объект датасета с основными параметрами расчета цены. Значение по умолчанию доступно в формулах тарифа и доп. услуг, через вызов "dataset.self".

*count - количество корреспонденций от клиента. (может показывать кол-во корреспонденции в текущем заказе или за прошлый месяц, в зависимости от выбранной схемы подсчета заказов в тарифе)
*tp - тип корреспонденции;
*mode - режим доставки;
*mass - масса отправления;
*TownFrom - код города отправителя;
*TownTo - код города получателя.

'''CalcAddressPrice(AddressCode, [,ZakazCount])''' - полностью пересчитывает стоимость доставки корреспонденции по тарифу клиента. AddressCode - внутренний код адреса, ZakazCount - не обязательный параметр, кол-во заказов от клиента.

'''GetStationCode(s [,town])''' – возвращает код станции метро, ассоциированный в системе с адресом s. В случае невозможности идентифицировать станцию метро – возвращает 0.
Когда включено районирование по карте, необходим второй параметр "town" - код города в котором нужно искать адрес. Возвращает код района если удалось его найти; код станции меж-города - если адрес удалось геокодировать, но район не нашли; код 0 - когда не удалось геокодировать адрес.

'''RecalcSpecialSMA(ActCode)''' - пересчитать акт передачи денег (АПД). Также, у корреспонденций входящих в АПД будет пересчитана стоимость доставки. Для Входящего АПД сумма акта не пересчитывается. Параметр ActCode - внутренний код акта, коды можно перечислять через запятую.

'''UserCode''' - Возвращает код текущего пользователя из таблицы «Пользователи» (users).

'''UserName''' - Возвращает имя текущего пользователя из таблицы «Пользователи» (users).

'''UserPass''' - Возвращает пароль текущего пользователя.

'''UserBaseCode''' – Возвращает код текущего пользователя из таблицы «Сотрудники» (kurier).

'''UserEmail''' - Возвращает e-mail текущего пользователя.

'''CurrentTown''' – Возвращает код текущего города (из таблицы town).

'''CurrentCity''' – Возвращает код текущего региона (из таблицы city).

'''CurrentLocation''' – Возвращает код текущего филиала (из таблицы store).

'''FromEmailStr''' - строка, содержащая данные для отправки письма – адрес SMTP-сервера (также к имени сервера можно добавить протокол ssl:// или tls://), порт, логин, пароль и email отправителя, разделенные символом переноса строки.

'''FillExcelDoc'''(Excel, Dataset, FormType, FormNumber,Print,[printer]) - Выполняет указанную печатную форму в объекте excel. Excel объект можно не указывать, тогда функция сама создаст объект экселя и разрушит его, полезно когда книгу
нужно распечатать или отправить по email (на листе данных в ячейке 1,1 укажите ключевое слово email). Dataset объект с данными для скрипта в печатной форме, может быть null. Dataset передавать можно так db.self, тогда переданный dataset внутри печатной формы будет доступен по имени dataset. Print - печатает книгу на принтере, после печати объект excel разрушается, при использовании параметра не указываете объект excel. Printer - имя принтера, на котором печатать (по умолчанию пустая строка, что означает "печатать на принтере по умолчанию"). Например:

new('TExcel', 'excel');
FillExcelDoc(excel.self, null, 12, 1);
excel.DoNotDestroy(true);
excel.SetVisible(true);
''Покажет эксель с выполненной печатной формой''

'''ValutaSign''' – Возвращает название валюты для суммы.

'''SendToMeasoft(xml)''' - Отправляет запрос в клиентское API Measoft. Автоматически добавляет начальный "<?xml version="1.0" encoding="utf-8"?>".

'''InsertFirmAtt(excel, sheet, firmcode)''' - Вставляем на лист эксель по коду фирмы: печать, подпись, подпись бухгалтера, логотип. Тэги <STAMP>, <DIR>, <BUH>, <LOGO> соответственно. После тега можно указать размеры изображения в символах Microsoft Excel. Формат записи: <STAMP> 16, 16

'''PreCalcSalary(kurier, addressCodes)''' - Рассчитывает предварительную зарплату. Kurier - код курьера, используется для определения тарифа. addressCodes - коды адресов, через запятую для которых необходимо посчитать зарплату. Результаты расчета будут записаны в таблицу kurierpaydetail, так как расчет предварительный то записи не будут прикреплены к конкретному начислению.

select a.code, kpd.price as "туда", kpd2.price as "обратно" from address a
left join kurierpaydetail kpd on kpd.sourcetable=3 and kpd.sourcecode=a.code and kpd.rectype = 1
left join kurierpaydetail kpd2 on kpd2.sourcetable=3 and kpd2.sourcecode=a.code and kpd2.rectype = 2
where a.code in (...)

'''CalcSalary(DateTo, [Filter=0, KurierCode = 0, ManagerCode = 0])''' - Полный расчет зарплаты курьерам. DateTo - дата до которой создается начисление. Условия отбора курьеров для начисления. Filter - роль сотрудника: 0 - Все, 1 - курьеры, 2 - менеджеры; KurierCode - код курьера, ограничить расчет зарплаты одним курьером;ManagerCode - код курьера, ограничить расчет зарплаты курьерами указанного менеджера. Внимание фильтры Filter, KurierCode и ManagerCode накладываются друг на друга. Результатом функции является SubSQL с информацией по созданным начислениям.
поля ответа: код курьера, код менеджера, начислено, бонусы, штрафы, аванс, итого;
select kurier, manager, profit, bonus, shtraf, prepay, total [union select ...]

'''SelDistAddr(s)''' – Возвращает строку для вставки в select запрос, для вывода поля с упрощенным адресом. Принимает один необязательный строковый параметр - алиас таблицы из которой будет упрощаться поле address, по умолчанию "a"

'''VoiceReadStr(str)''' – Озвучивает фразу str голосовым уведомлением доступными словами из базы. Может содержать тег "{break_off}" для того, чтобы сделать эту фразу не пропускаемой в очереди воспроизведения.

'''CalcStorageCost(ClientCodes, DateFrom, DateTo, NeedReport[, Store])''' – рассчитывает стоимость хранения на складе для выбранных клиентов (ClientCodes - коды клиентов через запятую), в период дат с DateFrom до DateTo, с прикреплением к корреспонденции отчета в зависимости от выставленного параметра NeedReport. Может содержать параметр Store - код филиала, по умолчанию пустой (расчет выполняется для всех филиалов). Возвращает коды созданных корреспонденций через запятую.

'''WriteOut(DocId, ItemId, Date, Cnt[, BC])''' – производит списание товара со склада. DocId - код (docs.code) документа списания, ItemId - код товара (item.code), Date - дата операции, Cnt - количество списываемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер. Если указан BC, то параметр ItemId игнорируется и поиск номенклатуры происходит исключительно по штрих-коду. В случае успеха, функция возвращает строку вида: код номенклатуры, списанное кол-во.

'''IncomePurch(DocId, ItemId, Date, Cnt[, BC, Location = CurrentLocation])''' – производит приход товара на склад. DocId - код (docs.code) приходной накладной, ItemId - код товара (item.code), Date - дата операции, Cnt - количество приходуемого товара, BC- штрих-код товара, для товара с учетом серийных номеров нужно обязательно указывать серийный номер, Location - код склада (store.code). В случае успеха, функция возвращает строку вида: код номенклатуры, введенное кол-во.

'''CreateLedgerDoc(Date, Client, UserCode, Type[, ExtNumber, Message])''' - создает складской документ и возвращает код этого документа. Date - дата документа. Client - код клиента. UserCode - код пользователя, создавшего документ. Type - тип документа (statetype = 13). ExtNumber - номер у поставщика для документов прихода и расхода. Message - комментарий к документу. Последние два аргумента не обязательные и могут быть пустыми.

== Объект TINIFile ==

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

Функции:

IniParam(s[,section='common']) – Существует только если имя экземпляра объекта пустое. Возвращает значение параметра s ini-файла секции «common», изменить секцию можно не обязательным параметром section. В случае отсутствия параметра в файле возвращает пустую строку.

Param(s) – Синоним IniParam с тем отличием, что существует только если имя объекта непустое.

SetText(s) - Загружает ini файл из строки s. Если в файле нет секции «common», то принудительно объявляет ее в начале.

== Объект TSMS ==

Предназначен для отправки SMS, а также проверки статуса их доставки.

Функции:

SetProxy(Server, Port, User, Pass) - Устанавливает настройки прокси-сервера.

Connect(Provider, Host, User, Pass, SenderName, SMSPrefix) – Подключает объект к провайдеру provider, используя адрес Host, имя пользователя User и пароль Pass. Значение SMSPrefix предназначено для того, чтобы провайдер мог различить сообщения от разных филиалов, если этими филиалами используется одно подключение. Если необходимости разделять сообщения нет - значение SMSPrefix можно не указывать.
Для провайдера доступны значения 'mirsms', 'sms16', 'websms', 'epochta', 'zanzara', 'SMSManager', 'f1sms', 'BitCall', 'mirsmsGET', 'AMD' и другие, либо можно указать числовые значения номера протокола, от 1 до <rspoiler text="20">Набор провайдеров все время дополняется, количество и номера можно смотреть в Справочники - Переменные - Подключения - SMS</rspoiler> соответственно. Эти значения соответствуют значениям переменной SMSProtocol таблицы "Value".

SendSMS(Phone, Text, [ID]) – Отправляет SMS с текстом Text на телефон Phone. Для некоторых провайдеров необходим уникальный идентификатор сообщения ID (для провайдера iVoice - идентификатор сценария (кампании)). Возвращает ID провайдера для последующей проверки статуса доставки.

CheckSMS(ProviderID) – Проверяет состояние доставки сообщения с идентификатором ProviderID. Возвращает: 0 – доставляется, 1 – успешно доставлено, 2 – не доставлено.

ReceiveSMS(InboxID, DateFrom, DateTo, NewOnly) - Получает входящие SMS, с ящика InboxID (идентификатор выдаётся провайдером). DateFrom, DateTo - задается временной интервал в котором были приняты сообщения(формат 08.04.2013 18:00:00 'DD.MM.YYYY HH:NN:SS'). Чтобы получать только новые сообщение поле NewOnly должно быть True. Возвращает XML с сообщениями.

ExtraResult([ParamName='']) - Вызывается после CheckSMS, возвращает дополнительную информацию по последнему статусу смс. В настоящее время работает только для провайдеров BitCall и iVoice. Для BitCall по умолчанию возвращает кнопки, нажатые абонентом во время работы с голосовым меню. Если в paramname указать 'IdentifyText' то будет возвращен JSON с ответами абонента на заданные вопросы(используется в случае звонков с индивидуальным сценарием). Для iVoice по умолчанию подразумевается параметр 'response', при этом будет возвращен JSON с ответами абонента на заданные вопросы (в зависимости от сценария)

Log - Возвращает последний HTTP запрос и ответ от сервера смс.

== Объект TXML ==

Предназачен для парсинга XML-данных.

Функции:

SetText(S) – Задает текст XML документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию. Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

AttribCount – Возвращает количество атрибутов текущего элемента.

AttribName(i) – Возвращает имя атрибута с номером i.

Attrib(V) – Ищет атрибут и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.

Reset – Делает текущим корневой элемент, возвращает его значение.

== Объект TJSON ==

Предназачен для парсинга JSON-данных.

Функции:

SetText(S) – Задает текст JSON документа для парсинга, делает текущим корневой элемент.

NodeValue – Возвращает значение текущего элемента.

NodeName – Возвращает имя текущего элемента.

OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Возвращает значение найденного элемента, или пустую строку, если элемент не найден. Нумерация элементов начинается с нуля.

ChildrenCount – Возвращает количество дочерних элементов.

ChildNodeValue(V) – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию (регистрозависимый поиск). Можно проверять наличие элементов, если элемента нет, вернется пустая строка.

OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.

Reset – Делает текущим корневой элемент, возвращает его значение.

isArray - Возвращает true, если текущий элемент является массивом (доступ к дочерним элементам возможен только по индексу, нумерация элементов начинается с нуля)

==Объект TZip==
Предназначен для работы с Zip архивом.

SetZip(s) - Загружает архив в объект из строки s;

GetZip - Возвращает архив в виде строки;

AddFromFile(SrcPath, ZipPath) - Добавляет файл SrcPath в архив и располагает его по пути ZipPath. ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

AddFromStr(Data, /*ZipPath*/) - '''параметр ZipPath временно не работает'''. Добавляет файл из строки Data в архив и располагает его по пути ZipPath. -ZipPath содержит имя файла в архиве, при необходимости можно указать каталог;

LoadFromFile(path) - Загружает архив из файла path;

SaveToFile(path) - Сохраняет архив в файл path;

Count - Возвращает кол-во файлов в архиве;

DataByIndex(index) - Возвращает распакованный файл в виде строки. Index - номер файла в архиве;

DataByName(ZipPath) - Возвращает распакованный файл в виде строки. ZipPath - путь к файлу в архиве, может содержать каталоги;

FileName(index) - По номеру файла, функция возвращает полный путь файла в архиве.

==Объект TBase==

'''Функции общего назначения''':

'''ExecSimpleScript(Caption, Text)''' - Выполняет скрипт "Дополнительных возможностей". Возвращаемые значения, введенные пользователем устанавливает в переменные $scriptvar1..$scriptvarN, Значения кодов списочных переменных - в переменных $scriptvar1codes..$scriptvarNcodes. Функция возвращает истину, если пользователь нажал "OK" в диалоговом окне.

'''FillAdvPriceReport(Excel, AddressCodes, StartLine, StartCol, [ShowSumPrice,InsertColumns,ShowAll])''' - добавляет отчёт по дополнительным услугам. В AddressCodes - указаны коды адресов через запятую, каждый код это отдельная строка отчета. Адреса будут показаны в порядке перечисления их в AddressCodes. Если в отчет нужно добавить пустую строку, то можно указать код адреса -1000. StartLine, StartCol - верхний левый угол выгружаемой таблицы. ShowSumPrice - добавить столбец итоговый столбец с суммой всех услуг, по умолчанию выключено. InsertColumns - раздвинуть таблицу перед вставкой отчета, позволяет встраивать отчет посередине выгрузки, по умолчанию выключено. ShowAll - показать все дополнительные услуги, по умолчанию false и показывает только услуги с начислениями. Функция возвращает количество использованных столбцов.

'''PrintSticker(Codes, [ToBoxes=False])'''

'''PrintBlanc(Codes, BlancNumber)''' - печатать форму из раздела "Заполнить бланк". Codes - коды корреспонденций, BlancNumber - номер формы из раздела "Бланки для корреспонденции" (3)

'''GetItemByName(Name)'''

'''GetA4Printer''' - возвращает имя принтера выбранного для печати документов

'''GetStickerPrinter''' - возвращает имя принтера выбранного для печати стикеров

'''GetDuplexPrinter''' - возвращает имя принтера выбранного для двусторонней печати, если принтер не выбран, возвращает пустую строку

'''PrintAttachPDFPage(Code, FileName, Page, Printer)''' - печатает страницу из вложенного файла PDF. Code - код вложения (attachment), Page - номер страницы, Printer - 0 = принтер A4, 1 = принтер этикеток.

'''AttachPDFToText(Code, [TextFileName])''' - преобразует файл PDF из вложений в текст. Code - код вложения (attachment), TextFileName - имя текстового файла, в который записывается результат (если не указан, используется временный файл). Возвращает текст в виде строки.

'''GhostScript(GScript, Code)''' — функция для выполнения консольных команд утилиты [https://ghostscript.readthedocs.io/en/latest/Use.html ghostscript]. Где, GScript — строка с командами Ghostscript; Code — код вложения или путь к PDF-файлу, предназначенному для обработки. В командах доступен специальный тег %MeasoftInFile%, который автоматически заменяется на путь к предварительно загруженному файлу (Code). Если в команде необходимо указать путь для сохранения результата обработки, используйте тег %MeasoftOutFile%. В этом случае функция на основании параметра Code автоматически сформирует имя временного выходного файла. После успешного выполнения команд функция возвращает путь к сгенерированному выходному файлу - %MeasoftOutFile%.

'''GetActiveForm([SkipFormName])''' - возвращает код активной формы в программе где происходит сканирование. SkipFormName - не обязательны параметр, имя формы которую нужно пропустить при определении интерфейса.
'''Список интерфейсов''':
0 - неопределенный;
1 - прием корреспонденции на склад;
2 - АПД;
3 - комплектация адресов (ShelfingForm);
4 - доска приема;
9 - вкладка «Манифесты»;
10 - Инвентаризация корреспонденции;
11 - АПК;
12 - вкладка «Адреса»;
13 - вкладка «Выдача»;
14 - вкладка «Склад»;
15 - Список номенклатуры;
16 - Инвентаризация склада;
17 - Приходная накладная;
18 - Списание товара;
19 - Карточка корреспонденции.

'''AddAddressScanLog(Code[, StrBarCode, IsManual, FromInterface, ExtraInfo])''' - добавляет событие сканирование для корреспонденции с кодом Code. Необязательные параметры: StrBarCode - сканируемый ШК корреспонденции (по умолчанию пустой), IsManual - галка ручного сканирования (по умолчанию false), FromInterface - код интерфейса сканирования (StateType=81, по умолчанию 0 - неопределенный), ExtraInfo - текстовый комментарий события.

'''RuleName(alias)''' - Выдает полный путь в дерева прав по псевдониму права.

'''ShowText(Caption:string, Value:string)''' - показывает пользователю окно с заголовком Caption и с многострочным полем со значением Value. Может быть полезен при отображении логов выполненной операции.

'''ShowScanError(msg [, Speek, Color, Abort])''' - выдает пользователю окно с текстом msg блокируя последующие действия сканирования. Если Speek - истинно, то сообщение проговаривается голосовым движком, по умолчанию выключено. Color - целочисленное число цвета, в который будет окрашен фон сообщения (по умолчанию = -1, стандартный). Abort - прервать выполнение скрипта, не показывая ошибку.

'''CheckRule(alias)''' - функция проверки разрешения у текущего пользователя системы, alias - псевдоним права. Возвращает 1, если право есть и 0, если права нет.
Пример: if(CheckRule('RSE'), ShowMessage('У пользователя есть право изменять счета'), ShowMessage('У пользователя нет права изменять счета'));

'''GetKurierMoney(KurierCode, DateEnd, NonCash)''' - возвращает баланс курьера с кодом KurierCode на дату DateEnd. NonCash - булевый флаг, если истинно, то будет рассчитан безнальный баланс;

'''Функции, работающие только в импорте БД из эксель:'''

ReplaceAddress

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

GetPrice

GetNewNumber - используется при импорте реестра, возвращает номер конверта в загружаемом заказе

GetNewPos - используется при импорте реестра, возвращает порядковый номер вложения

GetNewPackagePos- используется при импорте реестра, возвращает порядковый номер места

Zakaz - возвращает номер заказа куда происходит импорт реестра

addresscode - используется при импорте реестра, код созданного адреса

Source - код заказчика

ClientTown - Узнаем город клиента, через филиал с которым он работает. Сам клиент берется из заказа указанного в окне "Импорт БД из Excel".

== Объект TFieldObject ==
Создается только автоматически. Объект для доступа к записям, используется в картах и дополнительных услугах (addressrecord) и событиях карточки корреспонденции (fieldlist). Методы объекта:

'''_GetTableInfo''' - возвращает данные о полях и примеры данных объекта.

'''_Self''' - возвращает ссылку на объект.

'''_Set(fieldname, fieldvalue [, DoUpdateForm])''' - Если базовый объект строка. Устаналивает для поля fieldname значение fieldvalue. DoUpdateForm по уолчанию false, если указать true то обновление поля будет не только в объекте но и пользовательском интерфейсе. Обновление работает только в карточке корреспнденции для ограниченного набора полей: vlog, mode, type, date_put, time_put, message, kurier, state1.

'''_Set(keyfield, keyvalue, filed, value)''' - Если базовый объект таблица (addressrecord.boxes). Работает перегруженная версия метода _set, cначала происходит поиск строки по ключу, далее меняется значение указанного столбца. keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Пример, отключение услуги база:

addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

== Объект TMessage ==
Создается только автоматически. Объект используется для скриптовой обработки письма в [https://wiki.courierexe.ru/index.php/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F_%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8#.D0.98.D0.BC.D0.BF.D0.BE.D1.80.D1.82_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85| заданиях импорта данных]. В себе содержит текст письма в очищенном формате и оригинальном формате HTML, отправитель письма, тему письма, дата получения и список прикрепленных файлов.

'''Message.Text''' - возвращает очищенный от HTML-тегов текст письма.

'''Message.HTMLText''' - возвращает оригинальный текст письма со всеми HTML-тегами.

'''Message.Sender''' - возвращает email-адрес отправителя письма.

'''Message.AttachmentsCount''' - возвращает количество вложенных файлов.

'''Message.DateTime''' - возвращает дату и время получения письма.

'''Message.Subject''' - возвращает тему письма.

'''Message.GetAttachmentDataString(Number)''' - возвращает вложенный файл под номером Number в виде строки.

'''Message.GetAttachmentName(Number)''' - возвращает имя вложенного файла под номером Number.

== Объект TStringList ==
Может использоваться для построчной обработки многостраничных файлов либо для организации текстовых данных. Номер строк начинается с 0.
Имеет следующий функционал:

'''Count''' - возвращает количество строк в списке.

'''Add(Value:string)''' - добавляет значение Value в конец списка.

'''SetText(Value:string)''' - устанавливает значение списка в значение Value.

'''Insert(Number:integer, Value:string)''' - добавляет строку Value в позицию Number.

'''Delete(Number:integer)''' - удаляет строку из списка в позиции Number.

'''Clear''' - очищает элементы списка.

'''LoadFromFile(Path:string)''' - загружает текстовый файл по пути Path.

'''Strings(Number:integer)''' - возвращает строку с номером Number.

'''SetString(Number:integer, Value:string)''' - устанавливает значение строки с номером Number в значение Value.

'''Text''' - возвращает полный список строк в виде текста.

'''CommaText([Quoted:boolean])''' - возвращает список значений через запятую. Если Quoted = true, то квотирует элементы списка. По умолчанию равен false.

'''SetCommaText(Value: string)''' - разбивает значение Value на отдельные строки и кладет в список. Разделитель - запятые.

'''IndexOf(Value:string)''' - ищет значение Value среди элементов списка и если находит, то возвращает номер строки. Возвращает -1 если значение не было найдено.

'''Sorted(Value:boolean)''' - устанавливает флаг отсортированности списка в Value. Если Value = true, то сразу же его сортирует. По умолчанию Value = false.

'''Exchange(Pos1:integer, Pos2:integer)''' - меняет элементы списка с позициями Pos1 и Pos2 местами.

'''Duplicates(Value:integer)''' - изменяет параметр управления дубликатами в списке. Если Value = 0 (значение по умолчанию), то список не реагирует на дубликаты. Если Value = 1, то список при добавлении будет игнорировать дубликаты. Если Value = 2, то список будет выдавать исключение, при добавлении дубликата в список.

'''ParamName(Number:integer[, Delimiter:string])''' - возвращает текст до первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает пустоту.

'''ParamValue(Number:integer[, Delimiter:string])''' - возвращает текст после первого знака разделителя Delimiter (по умолчанию "=") из строки с номером Number. Если разделителя в строке нет, то возвращает всю строку.

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

Основные методы:

'''New'''(FuncName, Param1, Param2, ..., Body) — создание новой функции.Функция возвращает результат выполнения последней команды в теле функции. Аргументы:
* `FuncName` — имя функции (строка)
* `Param1, Param2, ...` — имена параметров функции (переменные начинаются с `$`, объекты — без префикса)
* `Body` — тело функции (скрипт, выполняемый при вызове)

'''FuncName'''(Arg1, Arg2, ...) — вызов созданной функции по имени. Если в объявлении была указана тип переменная, то и подставлять в аргумент надо обязательно переменную. Будет передано значение этой переменной (переменные словарине поддерживаются!). Если был объявлен объект, то указатель на объект должен быть получен через метод '''_self'''. C функциями поддерживают работу следующие классы: TExcel, TDirectExcel, TCSVFile, TADO, TSelfADO, TPrinter, TCanvas, TPicture, TTable, TINIFile, TSMS, TXML, TJSON, TZip, TStringList, TBaseUtils, а также объект addressrecord (TFieldObject). Результатом работы функции может быть число или строка.

Пример 1, обработка результатов функции:
<source>
<?>
new('TFunc', 'calc');
calc.new('Sum', '$a', '$b',
$a + $b
);

set($x, 10);
set($y, 20);
showmessage(calc.Sum($x, $y));
</source>

Пример 2, передача объекта в функцию:
<source>
<?>
new('TFunc', 'utils');
utils.new('ProcessDB', 'dbConn', '$value',
showmessage($value);
dbConn.open('SELECT * FROM address limit 3 ');
if(dbConn.recordcount > 0,
showmessage('Найдено записей: ' + dbConn.recordcount);
dbConn.first;
while(dbConn.eof = 0,
showmessage(dbConn.fieldbyname('code'));
dbConn.next
)
,0)
);

new('TSelfADO', 'db');
utils.ProcessDB(db._self,'test!');
</source>

== Применение языка формул ==
'''в различных контекстах системы «MEASOFT» и сопутствующих проектах'''

=== MEASOFT ===

==== Дополнительная информация на чеке ====

В карточке клиента на закладке «Касса» имеется поле для ввода текста, который будет отображаться на кассовых чеках, печатаемых для корреспонденции от данного клиента. В поле может быть введен как просто текст, так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TSelfDB с открытым набором данных со строчкой корреспонденции, заказа и клиента, на которую печатается чек

TBaseSupport

TBaseValue

Все объекты создаются с пустыми именами.

Так же система записывает в переменную $CashRegisterID вычисленный код фискального регистратора, на котором предполагается печать чека.

Результат работы скрипта печатается на создаваемом чеке, если скрипт не возвращает значение “-1” (число или текст) – в этом случае система чек не создает. Подразумевается, что либо скриптом было принято решение об отсутствии необходимости формирования чека, либо скрипт взял эту функцию на себя.

==== Заполнение шаблонов печатных форм ====

==== Дополнительные возможности ====

==== Импорт БД из Excel ====
В окружении интерпретатора создается объект ZakazRecord, он является списком со значениями таблицы zakaz. Именно в этот заказ будут загружены данные. Из этого объекта также доступно : 
*ZakazRecord.userfields - пользовательские поля заказа;
*ZakazRecord.Clients - данные таблицы clients;
*ZakazRecord.Clients.userfields - пользовательские поля заказчика.

==== Прайс лист клиента ====

Формула возвращает сумму в валюте клиента для каждой поездки (туда или обратно) единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Помимо стандартных объектов, система создает объект AddressRecord, в котором, как свойства, доступны все поля текущей записи. Так же она выставляет значение переменной $Forward в 1 (истина), если необходимо произвести расчет для направления "Туда" и 0 (ложь) - если обратно. ВНИМАНИЕ! Как и во всех остальных местах, после формулы нельзя ставить ";", иначе скрипт вернет 0!

Например:

if(int(AddressRecord.Time_Put_Max)>19, 100, 0)

''Прибавляет 100 рублей в случае, если максимальный срок доставки 20 часов или более''

if(pos(AddressRecord.Address, 'Аренда')>0,
set($FormulaReplace, 1);
1500
, 0)

''В случае наличия подстроки "Аренда" в адресе заменяет штатное ценообразование на 1500 рублей''

Объект AddressRecord может предоставить доступ к связанным таблицам :
* addressrecord.boxes
* addressrecord.packages
* addressrecord.clients
* addressrecord.price
* addressrecord.advprice
* addressrecord.userfields
* addressrecord.addressfld
* addressrecord.clients.userfields
* addressrecord.price.userfields
* addressrecord.zakaz
* addressrecord.zakaz.userfields

Чтобы получить доступ к полю VarCode из таблицы userfields необходимо записать AddressRecord.Userfields.VarCode. В присоединённой таблице может быть несколько записей чтобы получить к ним доступ предусмотрены функции _First, _EOF, _Next, _RecordCount, _Set.

Пример:
set($value1, 0); set($value2, 0);
while(AddressRecord.userfields._EOF=0,
if(AddressRecord.userfields.varCode=1,
set($value1, if(AddressRecord.userFields.VarValue='Праздничная упаковка', 150, 0)), ''''''');
if(AddressRecord.userfields.varCode=2,
set($value2, AddressRecord.userFields.VarValue), ''''''');
AddressRecord.userFields._Next;
);
int($value1) + int($value2)

Пример делающий тоже самое что и выше но через поиск Locate:
set($value1, if(addressrecord.userfields.VarValue('VarCode', 1)='Праздничная упаковка', 150, 0));
set($value2, int(addressrecord.userfields.VarValue('VarCode', 2)));
$value1 + $value2

В скрипте доступны переменные:
«$FormulaKoeff» - это коэффициент на который умножится конечная цена (по умолчанию равна 1);
«$PriceCode» - код прайса;
«$CurrentPriceConf» - код услуги;
«$BasePrice» - стоимость всех услуг с уровнем (pricelevel) меньше текущего.

Для вызова функции CalcBasePrice (Расчёт базовой цены) в скрипте объявленны переменные: $Count,$Collection,$Distance,$Wait.

Существует поиск по ключевому полю (поиск регистронезависимый), например чтобы найти в таблице advprice введённое значение для текущей услуги, нужно сделать такую запись addressrecord.advprice.value('priceconf', $CurrentPriceConf) - Первый параметр это ключевое поле, второй искомое значение. Если запись найдётся будет возвращено значение поле value, если нет функция вернёт значение 0.

Пример
if(addressrecord.advprice.active('priceconf', 3)='T', addressrecord.advprice.price, 0)

''Смотрим включена ли услуга и если да, возвращаем рассчитанную стоимость

Чтобы изменить значение записанное в объект addressrecord, нужно воспользоваться методом _set(keyfield, keyvalue, filed, value). Параметр keyfield - ключевое поле, keyvalue - искомое значение, filed - имя столбца, value - новое значение столбца. Сначала происходит поиск строки по ключу, далее меняется значение указанного столбца.
Пример, отключение услуги база:
addressrecord.advprice._Set('priceconf', 1, 'active', 'F')
priceconf - поле где записан код услуги;
1 - услуга База;
active - поле показывающее включение услуги.

Также существует упрощенный метод _set, с двумя параметрами filed, value - он используется в шаблонах загрузки или в системных доп. возможностях где доступен объект addressrecord.

==== Зарплата курьеров ====

Формула возвращает сумму в основной валюте для каждой единицы корреспонденции, которая добавляется к штатному ценообразованию. Если формула установила в значение «Истина» переменную «$FormulaReplace», то значение, возвращаемое формулой заменяет штатное ценообразование. Переменные «$FormulaTablKoeff» и «$FormulaMoneyKoeff» позволяют установить повышающий или понижающий коэффициент на стоимость доставки (по тарифной сетке) и услуги соответственно (процент от суммы, процент от стоимости доставки, ожидание). Переменная «$UsingZoneName» и «$KurierZone» содержат название и код зоны соответственно, есть возможность поменять название зоны для отчета.

=== Планировщик ===

В поле текста задания может быть введен как текст с командами планировщика (см ниже), так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:

TIniFile, Указывает на настроечный ini-файл планировщика.

Все объекты создаются с пустыми именами.

Для записи в лог планировщика нужно использовать функцию Print

=== Репликатор ===

== Прочее ==
ReplaceAddress(target, address) – Возвращает адрес последней доставки корреспонденции получателю target по адресу address от текущего клиента. При отсутствии такой доставки, возвращает address.

GetPrice –возвращает рассчитанное значение цены, на основе прайс-листа клиента и данных о корреспонденции.

GetKurierByStation(i) – возвращает код курьера, ассоциированного со станцией метро с кодом i.

GetNewNumber – Возвращает не занятый номер единицы корреспонденции в текущем заказе.

==История изменений==

=== Недавние изменения ===
{|
||'''Добавлено:'''
|2025.0.0.539 Добавлена поддержка отладчика AttachDebugger
|-
||'''Добавлено:'''
|2025.0.0.534 Добавлена поддержка оператора CASE и класса TFunc
|-
|}

=== Версия 2021.0.0.57 от 18.06.2019 ===
{|
||'''Добавлено:'''
|В объект TExcel добавлен метод ColumnDelete.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция InsertFirmAtt.
|-
||'''Добавлено:'''
||В объект TExcel добавлен метод Align.
|-
||'''Добавлено:'''
|Функция CheckEan
|-
||'''Добавлено:'''
|В объект функцию FillAdvPriceReport добавлены параметры ShowSumPrice,InsertColumns
|-
||'''Добавлено:'''
|В объект TSMS добавлен метод Log.
|-
||'''Добавлено:'''
|Добавлена функция Money.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция ValutaSign.
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция GetPolygonByLatLon.
|-
||'''Добавлено:'''
|В объект TTable добавлена функция SetMultiHeader, SetCustomHeader.
|-
||'''Добавлено:'''
|Функция DownloadAttachment
|-
||'''Добавлено:'''
|В функцию SetRowHeight объекта TExcel добавлен параметр cnt.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция AsString.
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция SetSize.
|-
||'''Добавлено:'''
|В объект TADO добавлена функция ParseForIn.
|-
||'''Изменено:'''
|В объект TBaseUtils из TBase перенесена функция FillExcelDoc.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция CalcAddressPrice
|-
||'''Изменено:'''
|Все функции класса TBaseSupport перенесены в TBaseUtils. Класс TBaseSupport больше не существует.
|-
||'''Добавлено:'''
|В функции RowInsert и RowDelete объекта TExcel добавлен параметр count.
|-
||'''Добавлено:'''
|В объект TBaseUtils функция SendToMeaSoft
|-
||'''Добавлено:'''
|В объект TBaseUtils функция RecalcSpecialSMA
|-
||'''Добавлено:'''
|Новая функция Reverse
|}

=== Версия 849   22.02.2018 ===

{|
||'''Добавлено:'''
|В функцию TBaseUtils.TownByIndex добавлен параметр PriorityName
|-
||'''Добавлено:'''
|В объекте TBase добавлена функция GetNewPackagePos
|-
||'''Добавлено:'''
|В объекте TSMS доработан метод ExtraResult, добавлен параметр ParamName
|-
||'''Добавлено:'''
|В объект TBase добавлена функция CalcAgentPrice
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateAddressForActDelivery
|-
||'''Изменено:'''
|Функция CalcTownDeliveryDate заменена на CalcDeliveryDate
|-
||'''Добавлено:'''
|В объект TBaseUtils добавлена функция CreateSpecialSMA
|-
||'''Добавлено:'''
|Функция SignatureUrl
|-
||'''Добавлено:'''
|В объект TPicture добавлена функция LoadFromStr.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetPen.
|-
||'''Добавлено:'''
|В объект TCanvas добавлена функция SetBrush.
|-
||'''Добавлено:'''
|В объект TPicture добавлена поддержка чтения в формате PNG.
|-
||'''Добавлено:'''
|В функцию TCanvas.DrawPic параметр Mode
|-
||'''Добавлено:'''
|Свойство TPicture.Canvas
|-
||'''Добавлено:'''
|Функция DeleteFile
|}

=== Версия 758   29.03.2017 ===
{|
||'''Добавлено:'''
|Функция GetPolygonByAddress
|-
||'''Добавлено:'''
|Функция ParamsCount
|-
||'''Добавлено:'''
|Объект TZip
|-
||'''Изменено:'''
|Функции CreateEAN и Create128 заменены одной функцией CreateBar, полностью совместимой с Create128, но добавлена поддержка EAN-13 и Interleaved 2-5 (для Почты России). В системе функции оставлены для обратной совместимости, но более не являются документированными и рекомендованными к использованию.
|-
||'''Добавлено:'''
|Параметр text в функцию Cell объекта TExcel
|-
||'''Добавлено:'''
|Функция UrlEncode
|-
||'''Добавлено:'''
|Функция IncDay теперь может принимать параметр count
|-
||'''Добавлено:'''
|Функции FtpGet, FtpPut, TTable.SetCell()
|}

=== Версия 452   26.02.2014 ===

{|
||'''Добавлено:'''
|Функция Time
|-
||'''Добавлено:'''
|Функция FixedIntToStr
|-
||'''Добавлено:'''
|Функция TimePeriod
|-
|'''Добавлено:'''
|В интерпретатор добавлена функция приёма смс - ReceiveSMS
|-
|'''Добавлено:'''
|Функция STR2UTF
|-
|'''Добавлено:'''
|Функция SAVETOFILE
|-
|'''Добавлено:'''
|Функция TExcel.SetSheetName
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "FILESTR"
|-
|'''Добавлено:'''
|Расширены возможности объекта addressrecord в формулах тарифов
|}

=== Версия 308   24.11.2012 ===

{|
|'''Добавлено:'''
|В функции загрузки таблиц из TADO добавлено условие, что поля, названия которых начинаются с "-" не выгружаются. Таким образом можно скрывать служебные поля из результирующего набора.
|-
|'''Добавлено:'''
|Функция TExcel.RowAutoFit
|-
|'''Добавлено:'''
|Функция TExcel.RowInsert
|}

=== Версия 300   01.11.2012 ===

{|
|'''Добавлено:'''
|В объекте TCSVFile добавилась возможность запрашивать значения не только текущей записи через параметр сдвига
|-
|'''Добавлено:'''
|В пользовательские отчеты добавлен тип "UPDOWN"
|-
|'''Добавлено:'''
|В интерпретатор добавлен объект TCSVFile
|}

=== Версия 266   14.09.2012 ===

{|
|'''Добавлено:'''
|В интерпретатор добавлена поддержка массивов
|}

=== Версия 265   11.09.2012 ===

{|
|'''Добавлено:'''
|Функция CreateTrans в интерпретатор
|-