Базовый синтаксис C#
1. Нативные расширения
Вы можете подключить любые скомпилированные на C# DLL содержащие функции и классы расширения синтаксиса языка. И нужно просто поместить в папку, указанную в нейристоре System в свойстве _UsingDLLFolder, – по умолчанию /Plugins
2. Диалоговые операторы
В скриптах, особенно когда вы будете создавать собственные расширения \инструменты, вам понадобятся диалоговые запросы к пользователю Socratis.Studio
ВНИМАНИЕ: не пытайтесь применять эти операторы в целевом приложении для диалога с клиентом (за пределами Socratis.Studio). Они предназначены исключительно для расширения функций самой Socratis.Studio.
Для целевого приложения используйте только средства конструктора UI интерфейса.
2.1. Кнопки выбора
Вы можете создать запрос с любым количеством кнопок выбора вариантов:
result = ButtonDialog("Надпись","вопрос","111","222","333");
2.2. Запрос текста
Выводит сообщение и ждет ввода пользовательского текста:
result = InputDialog("Надпись","вопрос","по умолчанию");
result = InputDialog("Надпись”, “вопрос");
2.3. Выбор файла
selectedFile = PickFileDialog("Выберите файл проекта Socrates");
2.4. Описание файла
Позволяет описать файл и его данные.
Возвращает массив из 4 элементов: [Название, Категория, Источник, Описание]
3. Умный селектор текста SmartSwith
SmartSwith(script, key); вычисляет строковое выражение DSL относительно входного значения key. В зависимости от префикса script оператор может вернуть литеральное значение, значение глобальной переменной, результат выполнения скрипта или результат выбора одного из вариантов.
Результат имеет тип object?, поэтому может быть строкой, числом, логическим значением, объектом, null или пустой строкой.
Порядок обработки
Оператор проверяет выражение в следующем порядке:
- null
- Скриптовый макрос @(…).
- Точное сопоставление @swith:.
- Семантическое сопоставление @like:.
- Сопоставление по наличию текста @contains: или фактически распознаваемого варианта @contain:.
- Скрипт с префиксом @ — символ @, за которым следует пробел.
- Имя глобальной переменной, начинающееся с @.
- Обычный текст, который возвращается без изменений.
Пробелы в начале выражения не влияют на распознавание префикса, поскольку перед проверкой используется Trim(). Однако само значение обычно не очищается от пробелов перед возвратом.
Поддерживаемые формы
Литеральное значение
Если script не начинается с одного из специальных префиксов, он возвращается как есть.
csharp
SmartSwith("Привет", "любой ключ");
Результат:
Привет
Аргумент key в этом случае не используется.
Если передать значение null, результатом также будет null:
csharp
SmartSwith(null, "key");
Результат:
null
3.1. Глобальная переменная
Форма:
text
@ИмяПеременной;
или:
text
@ИмяПеременной
После удаления символа @ имя передается в механизм поиска глобальных переменных.
Пример:
csharp
SmartSwith("@ApplicationName;", "ignored");
Если глобальная переменная ApplicationName имеет значение SmartSwitch DSL, результатом будет:
text
SmartSwitch DSL
Если переменная не найдена, оператор возвращает исходное имя без символа @. При наличии завершающей точки с запятой она сохраняется:
csharp
SmartSwith("@Unknown;", "ignored");
Фактический результат:
Unknown;
Таким образом, отсутствие переменной не приводит к исключению. Выражение превращается в обычный текст без маркера @.
3.2. Произвольный скрипт @(…)
Форма:
text
@(выражение)
Предназначена для вычисления произвольного DSL-скрипта.
Пример предполагаемого использования:
csharp
SmartSwith("@(2 + 3)", "ignored");
Предполагаемый результат:
5
Перед выполнением из выражения удаляются комментарии. Если скрипт не заканчивается точкой с запятой, она добавляется автоматически.
Внутренне выражение преобразуется примерно так:
text
@(2 + 3)
в:
text
2 + 3);
Затем оно передается интерпретатору скриптов.
Важно: текущая реализация удаляет последовательность @(, но не удаляет закрывающую скобку). Поэтому выражение @(2 + 3) может быть передано интерпретатору в синтаксически некорректном виде. Если интерпретатор не поддерживает такой формат, макрос необходимо исправить либо документировать без закрывающей скобки.
При невозможности вычисления выражения возвращается преобразованный текст скрипта, например:
text
2 + 3);
3.3. Скрипт с префиксом @
Форма:
text
@ выражение
В отличие от @(…), здесь после символа @ обязательно должен находиться пробел.
Пример:
csharp
SmartSwith("@ 2 + 3", "ignored");
Перед выполнением маркер @ удаляется:
text
2 + 3
Если отсутствует завершающая точка с запятой, оператор добавляет ее:
text
2 + 3;
Затем выражение передается в интерпретатор скриптов.
Этот вариант не имеет проблемы с лишней закрывающей скобкой и может использоваться для коротких выражений:
text
@ UserName;
@ Price * Count;
@ IsEnabled ? "Да" : "Нет";
Выбор значения по ключу
3.4. Точное совпадение: @swith:
Формат:
text
@swith: вариант1=> результат1; вариант2=> результат2; значениеПоУмолчанию
Каждая пара имеет вид:
text
условие=> результат
Последний элемент без => рассматривается как значение по умолчанию.
Пример:
csharp
SmartSwith(
"@switch: red=> Красный; green=> Зеленый; blue=> Синий; Неизвестный цвет", "green");
Результат:
Зеленый
Алгоритм:
- Выражение после @swith: разделяется по символу;.
- Каждый непустой элемент разделяется по последовательности =>.
- Левая часть сравнивается с key.
- При сравнении у обеих сторон удаляются начальные и конечные пробелы.
- При первом точном совпадении возвращается правая часть.
- Если совпадений нет, возвращается значение без =>.
- Если значения по умолчанию нет, возвращается пустая строка.
Пример со значением по умолчанию:
csharp
SmartSwith(
"@switch: admin=>Администратор; user=>Пользователь; Гость", "operator");
Результат:
Гость
Сравнение чувствительно к регистру:
csharp
SmartSwith(
"@switch: yes=>Да; no=>Нет; Неизвестно", "YES");
Результат:
Неизвестно
Поскольку в коде используется обычное сравнение строк, yes и YES считаются разными значениями.
Особенности синтаксиса
Правая часть не очищается от пробелов:
text
@swith: yes=> Да
может вернуть строку:
text
" Да"
с начальным пробелом.
Разделитель => должен встречаться ровно один раз. Конструкция с дополнительным разделителем:
text
@swith: a=>b=>c; default
не считается корректной парой и будет обработана как значение по умолчанию, фактически дав результат:
text
a
3.5. Сопоставление по наличию текста: @contains:
Предполагаемый формат:
text
@contains: фрагмент1=>результат1; фрагмент2=>результат2; значениеПоУмолчанию
Пример:
csharp
SmartSwith(
"@contains: домашний кот=>Животное; красный автомобиль=>Транспорт; Неизвестно", "кот");
Смысл проверки в текущей логике — проверить, содержит ли левая часть условия значение key:
text
"домашний кот".Contains("кот")
Так как условие выполняется, результатом должно быть:
text
Животное
Другой пример:
csharp
SmartSwith(
"@contains: Минск является столицей Беларуси=>Беларусь; Нет совпадения", "столицей");
Результат:
Беларусь
При проверке key предварительно очищается от пробелов:
text
" кот " → "кот"
Левая часть условия очищается от пробелов только при разборе пары, но сама проверка Contains выполняется над полученной строкой.
Если совпадений нет, используется значение по умолчанию:
csharp
SmartSwith(
"@contains: красный=>Красный; зеленый=>Зеленый; Другой цвет", "синий");
Результат:
Другой цвет
Если значение по умолчанию отсутствует, результатом будет пустая строка.
3.6. Семантическое сопоставление: @like:
Формат:
text
@like: описание1=>результат1; описание2=>результат2; значениеПоУмолчанию
Для каждой пары вычисляется оценка смысловой близости между левой частью и key:
text
оценка = Relanker.GetScore(условие, key)
Предполагаемая цель — выбрать наиболее похожее условие.
Пример нормативного поведения:
csharp
SmartSwith(
"@like: столица Беларуси=>Минск; столица России=>Москва; Неизвестный город", "главный город Беларуси");
Если модель семантической близости считает вариант столица Беларуси наиболее подходящим и его оценка не меньше 0.6, ожидаемый результат:
text
Минск
Порог 0.6 зафиксирован в реализации:
text
score < 0.6
Если максимальная оценка ниже порога, должно использоваться значение по умолчанию:
csharp
SmartSwith(
"@like: столица Беларуси=>Минск; столица России=>Москва; Неизвестный город", "погода на завтра");
Ожидаемый результат:
Неизвестный город
При вычислении учитываются только элементы, распознанные как пары условие => результат. Первый элемент без => немедленно считается значением по умолчанию, после чего дальнейший разбор прекращается.