Тут представлено опис 110 нових скриптових функцій, які появилися в програмі Digitals з грудня 2020 року (саме тоді на сайті були внесені останні зміни в описі скриптових функцій). Їх внесено в кожний з відповідних розділів. Загалом це такі нові функції:
Кермування скриптом
@BreakIf Condition - зупиняє роботу скрипту, якщо умова істинна (або пуста)
@Dialog.Information Text - Виводить повідомлення з інформацією
@Dialog.ShowImage URL - виводить вікно із зображенням, отриманим із вказаного URL
@Dialog.Memo Header|Text > Text - виводить діалогове вікно для введення тексту (багаторядковий варіант), де Header - його заголовок
@Dialog.CheckList Text - виводить діалогове вікно з можливістю позначати декілька пунктів із списку
@Dialog.EditFields Var1=Value:Name,... - виводить діалогове вікно для заповнення/редагування іменованих значень
@Dialog.EditRoute Name - виводить спеціальне діалогове вікно для заповнення даних з теодоліта
@SingleClickDialogs [1/0] -
@DocumentFromTemplate TemplateName|DocName|Options|Key1=Value1|... - створює документ за шаблоном та замінює змінні в ньому на потрібні значення
@Thread ScriptCommand - запускає скрипт в одному з потоків процесора
@ThreadActive Handle - активний потік процесора ПК
@WaitForThread - чекає на активний потік процесора
@Map.Constant [Name=Value or Name] - записує/зчитує значення будь-яких іменованих констант з прив'язкою до конкретної карти (але без зберігання її після закривання карти)
@SQL.Table.Extract Tablename(field1,...) Condition - видобуває таблицю через SQL
@SQL.Table.Insert Tablename(field1=...) - вставляє таблицю через SQL
@SQL.Table.Select Tablename(field1,...) Condition - виділяє таблицю через SQL
@SQL.Table.Update Tablename(field1=...) Condition - оновлює таблицю через SQL
@SQLAlterTable Table(field1,field2,...) - після таблиці SQL
@SQLCreateTable Table(field1,field2,...) - створює таблицю через SQL
@SQLDequoteText - видаляє одинарні лапки на початку і в кінці текстового рядка в SQL
@SQLEditTable Query - редагує таблицю через SQL
@SQLViewTable Query - показує таблицю через SQL
Обробка подій
@Map.Layers.Script Number [ScriptText] - повертає або встановлює скрипт обробки подій шару
Файли та папки
@RenameFile OldFilename|NewFilename - перейменовує заданий файл і повертає 0 у випадку успіху
@DownloadFileExists Filename - повертає 1, якщо файл за вказаним URL існує, і 0 - якщо ні
@Map.RenamePhotos PhotoParamIndex IDParamIndex - перейменовує файли із параметру PhotoParamIndex
@RenameJSONFiles Path - приводить назви JSON-файлів у відповідності до назв PDF (по даті створення)
@ClearFilename Filename - повертає повну назву файлу без шляху
@FileDate Filename - повертає дату файлу (число днів з 30 грудня 1899 року)
@FileSize Filename - Повертає розмір файлу (в байтах)
Карта
@Map.EmbedMap FileName - відкриває вмонтовану карту із зовнішнього файлу
@Map.Background 0/1 - робить основну карту фоновою, показуючи вмонтовані поверх неї
@Map.InsertGrid Layer X0 Y0 DX DY ObjIndex CreateCaption SmallScale Solid - вставляє сітку в заданий об'єкт чи в рамку карти аналогічно меню Вставка-Сітка. Аргументи функції:
@Map.InsertSheetLayout Layer X0 Y0 DX DY Overlap ObjIndex - вставляє розбивку на листи в заданий об'єкт чи в рамку карти аналогічно меню Вставка-Сітка. Аргументи функції:
@Map.FromArchitectural 0/1 - встановлює архітектурну форму карти
Система координат
@Map.SwapXY - міняє місцями координати Х та У для всіх об'єктів карти
@Map.ToWGS84 X Y [Z] > B L [Z] - переводить координати точки з прямокутної системи в широту/довготу
@Map.FromWGS84 B L [Z] > X Y [Z] - переводить координати точки з широти/довготи в прямокутну систему
Управл. об'єктами карти
@Map.GetExternalNeighbors ObjectNumber - повертає список номерів об'єкта, які є суміжниками
Геометрія об'єктів
@WGS84Azimuth B1 L1 B2 L2 - вираховує азимут і відстань по двох геодезичних точках
@Map.Object[N].ToCircle - створює круг по зовнішніх точках вказаного об'єкта
@Map.Object[N].AddBreak - додає розрив за останньою точкою об'єкта (для того, щоб потім додати ще точки після цього, а якщо не додати - то розбрив зникне)
@Map.Object[N].IsBreak PointIndex - повертає 1, якщо PointIndex-а точка об'єкту є розривом, та повертає 0 якщо це звичайна точка
@Map.Object[N].SubObjects - повертає кількість частин об'єкта, що розділені розривами
@Map.SharedBorderCount ObjIndex1 ObjIndex2 - повертає кількість ребер спільної межі двох об'єктів карти
@Map.LoadFromText String - завантажує координати об'єкта із списку в текстовому форматі
@Map.LoadFromWKT WKTString - завантажує координати об'єкта із рядка в форматі Well Known
Параметри
@ShowParameters - показує список параметрів виділеного об'єкта
@Map.Parameters.FixedListCount ParamIndex - повертає кількість значень спискового параметру
@Map.Parameters.FixedListValue ParamIndex ListIndex [NewValue] - повертає/змінює рядок із списку параметру за його індексом
@Map.ParseAddresses ParamIndex - розділяє адресу за комами
@Map.ClearUnusedParameters - очищує параметри об'єкта, які не присвоєні шару
Умовні знаки
@Map.Symbols.Generalize MicronAccuracy - розріджує кількість точок і ліній в умовних знаках
Растри
@Map.ImageList - повертає список растрів, що вставлені в карту
Горизонталі та 3d-графіка
@Map.MergeLayerPointsByParameter Layer1 Layer2 Param1 Param2 - впорядковує горизонталі
Робота з текстом
@Text[N].Columns ColumnIndex1 ColumnIndex2 ... - залишає в текстовому контейнері тільки задані колонки, видаляючи всі решту
@Text[N].Value Key - повертає значення за ключем Key із списку, який виглядає як Ключ=Значение
@Text[N].Prefix Value - додає текст (Value) на початок кожного з рядків
@Text[N].Suffix Value - додає текст (Value) в кінець кожного з рядків
@Text[N].Trim - видаляє пробіли на початку і в кінці кожного з рядків
@Text[N].RemoveChar Char - видаляє символ Char із усіх рядків
@Text[N].Reverse - змінює порядок рядків на протилежний
@Text[N].Leading Char - доповнює всі рядки контейнера символом Char до заданої довжини, наприклад, роблячи в числах однакову кількість цифр після коми (якщо Char вказано як 0)
@Text[N].Clip Char - видаляє в кожному рядку всі символи зліва (починаючи з першого) до символу Char включно (якщо є декілька таких в рядку - до останнього)
@Text[N].LengthFilter Condition - видаляє рядки за їх довжиною, наприклад Text[N].Filter <1 видалить всі пусті рядки; доступні значення >,<,=,<>
@Text[N].Merge Text[Index] - додає в текстовий контейнер N елементи (рядки) із текстового контейнера Index
@Text[N].Append Text[Index] - додає вказані (Index) рядки в кінець текстового контейнера N
@Text[N].Assign Text[Index] - присвоює значення текстового контейнера Index текстовому контейнеру N
@Text[N].Intersect Text[Index] - видаляє з текстового контейнера N рядки, які відсутні в текстовому контейнері Index
@Text[N].Subtract Text[Index] - видаляє з текствого контейнера N рядки, які є в текстовому контейнері Index
@Text[N].Trunc Char - видаляє весь текст, починаючи з символу Char
@Text[N].Unique [Length] - Обрізає рядки по заданій довжині, залишаючи тільки унікальні
@Text[N].Crop Start Count - замінює кожен рядок на його фрагмент, який починається з символу Start і має довжину Count
@Text[N].Histogram [Start Count] - рахує кількість входжень кожного фрагменту рядка в текстовому контейнері
@Text[N].Split LineCount Filename - зберігає частини текстового контейнера в окремі файли по LineCount елементів (рядків)
@Text[N].GroupFilter GroupLength - залишає тільки перше значення в кожній групі, що обмежена довжиною GroupLength
@Text[N].DelimitedText [String] - виклик функції без аргумента повертає вміст контейнера, аналогічно функції @Text[N].Text але розділовий символ умовних рядків за замовчуванням не знак переносу, а кома чи інший заданий наступною функцією (див.нижче). Виклик функції з аргументом змінює вміст контейнера, розбиваючи на рядки по новому розділовому символу та повертає кількість нову кількість рядків в контейнері.
@Text[N].Delimiter [Char] - задає або повертає символ-розділювач в текстовому контейнері
@Text[N].Parse - парсить текст в форматі JSON
@Text[N].ExplodeLine[N] var1,var2,... -
@Text[N].DecimalToAngle - перетвоює широту/довготу із десяткового вигляду у кутовий
@AngleToDecimal Value [Format] - переводить кутове значення (00°00'00") в десяткове (0.000)
@DecimalToAngle Value [Format] - переводить десяткове значення (0.000) в кутове (00°00'00")
@Not 0/1 > 1/0 - замінює 0 на 1, а 1 на 0
@Float Formula - повертає числовий результат виразу
@CalculateFormula Formula - виконує математичні обрахунки
@Money Formula - рахує вираз за формулою з округленням результату до двох знаків
@IsFloat Text - повертає 1, якщо текст містить тільки цифри і знаки +-,.
@IsInteger Text - повертає 1, якщо текст містить тільки цифри і знаки +-
@NextPeriodicDate PrevDate NumberOfMonths - вираховує наступну дату періодничного платежу
@StringCalc Text function - виконує текстову функцію, наприклад, Copy
@StringField Number String > Part - витягує частину рядка, що розділений символом табуляції
@StringFieldCount String > Count - повертає кількість частин рядка, що розділені символом табуляції
Управління програмою Digitals
@Map.ObjectLabel Formula - змінює формулу мітки об'єкта, задану в Константах (мітка об'єкту - це те, як він відображається у вікні, коли клацнути два рази по карті, вона прописується в константі ObjectLabel)
@TabletMode [1/0] - приховує головне меню, панель із закладками і інше, включаючи тим самим режим планшету
@Map.GPSLocation > X Y Z - повертає координати позиції GPS
@CropImageByPolygon ImageFileName - обрізати зображення за полігоном
@Map.StartRoute Name - початок маршруту
@CompileTLB ShortFilename - створює прив'язані до ключів скриптові панелі інструментів *.tlc з *.tlb
Вихід в інтернет
@Map.BrowseGoogleMap [ZoomLevel] [s/m/h] - вікриває карту Google в браузері у вказаній позиції і з вказаним рівнем зближення
@Map.BrowseOpenStreetMap [ZoomLevel] - відкриває карту OpenStreetMap в браузері із вказаним рівень зближення
@Map.BrowsePublicMap [ZoomLevel] [Layer:BaseLayer] - відкриває Публічну кадастрову карту в браузері із вказаним зближенням та базовими шарами
@Map.Object[N].GetPublicMapInfo - заповнює атрибути ділянки з ПКК
@UkrCadServer - ?
Інші не зрозумілі (без опису) функції:
@Map.Object[N].AlignToLayer LayerIndex - ?
@Map.ZB.UpdateParsels LayerIndex - ?
@Map.ZB.UpdateServi LayerIndex - ?
@Map.ArrangeFixedValues - ?
@Map.CheckSelectedByTriades [Limit] - ?
Примітка: жирним шрифтом (напр.@ActivateMap) виділена назва функції, похилим шрифтом (напр.Number) перемінна функції, у квадратних скобках (напр.[MapNumber]) необов'язкова перемінна, яку можна не вказувати.