in-Line Kit
Первое выражение, сочетания клавиш Студии и последовательный маршрут изучения.
Что такое in-Line Kit
in-Line Kit — встроенный язык подстановок Private Keeper. Вы записываете переменную, функцию или условие прямо в поддерживаемом поле проекта, а интерпретатор заменяет эту запись данными текущего запуска.
Обычный текст остаётся текстом. Специальные записи выделяются вертикальными чертами: |LOGIN| возвращает логин, |PARS|[1] — первый результат обычного парсера, а |UPPER|...|UPPER| переводит вложенный текст в верхний регистр.
Если обработка помещается в одно поле, обычно достаточно in-Line Kit. Для нескольких последовательных действий, условий или циклов в JavaScript используйте внутри Скрипт-бокса.
Первое рабочее выражение
Скопируйте выражение в поле проекта, где разрешена обработка in-Line:
Вход
Постоянная строка private keeper находится между двумя метками функции.
Вычисление
Круглые скобки обозначают внешнее вычисление, а парные метки |UPPER| задают функцию и её входные данные.
Результат
Поле получает строку PRIVATE KEEPER.
Начальная функция заключается в круглые скобки. У вложенных функций отдельные закрывающие скобки не добавляются: их границы задают собственные парные метки. Полные правила вложенности и ошибочные записи разобраны в обзоре функций.
Сочетания клавиш
| Клавиши | Действие |
|---|---|
F1 | Проверить проект |
Ctrl+S | Сохранить проект на компьютере |
Ctrl+Shift+S | Сохранить проект на сервере |
Ctrl+R | Восстановить последнюю сохранённую на компьютере версию |
Ctrl+Shift+R | Скачать и загрузить последнюю сохранённую на сервере версию |
Ctrl+F | Найти текст во всех запросах проекта |
Сохранение и проверка — разные действия. Ctrl+S не запускает проверку, а F1 не сохраняет изменения.
Проверка с выбранного действия
Чтение HTTP-ответа
У обычного HTTP-действия нажмите кнопку + рядом с методом запроса. Настройка
принадлежит только этому действию и не появляется у WebSocket или Mail Connector.
| Режим | Что получает проект |
|---|---|
| Полный ответ | Всё тело ответа; это обычный режим по умолчанию. |
| Первые N КиБ тела | Не больше указанного размера несжатого тела. Если сервер использует сжатие, Keeper получает и распаковывает ответ полностью. |
| Только заголовки | Строку статуса и весь блок заголовков без тела. |
| Только строка статуса | Итоговую строку статуса без остальных заголовков и тела. |
| До указанного заголовка | Строку статуса и заголовки до найденного имени включительно, без оставшейся части ответа. |
Имя конечного заголовка сравнивается без учёта регистра. Укажите только имя,
например X-Request-ID; значение вводить не нужно. Если настроен ограниченный режим,
кнопка + меняет цвет, поэтому такое действие видно в списке без повторного открытия
формы.
Бинарные сообщения WebSocket
В редакторе сообщения WebSocket флажок «Декодировать в байты» означает, что поле содержит Base64. Перед отправкой Keeper декодирует его и передаёт полученные байты. Без флажка текст поля кодируется как UTF-8.
Тип принятого кадра определяет значение |RESPONSE|: текстовый кадр возвращается как
обычный текст и обязан быть корректным UTF-8, а бинарный возвращается в Base64. В
запрос подключения входят дополнительные заголовки текущего WebSocket-действия.
Порядок изучения
1. Основы языка
Переменные, входная строка, маска, определения, условия и логические блоки.
2. Скрипт-бокс
Многострочный сценарий, присваивание, цикл FOR, критическая секция и JavaScript-код.
3. Состояние выполнения
Расширенная статистика, контейнеры и данные, общие для параллельных потоков.
4. Функции
Выбор функции по задаче, точная запись, параметры, результат и отдельные примеры.