Для разработчиков

Выберите in-Line Kit или объект PK и начните с короткого рабочего примера.

В проектах Private Keeper есть два способа записать обработку данных: выражения in-Line Kit и JavaScript-код с объектом PK. Оба способа работают с данными текущего запуска, но предназначены для разных мест и разного объёма логики.

Как выбрать способ записи

in-Line Kit

Выберите in-Line Kit, когда значение нужно сразу подставить в адрес, заголовок, тело запроса, правило или другое поле проекта. Короткая операция записывается прямо рядом с данными, которые она изменяет.

Объект PK

Выберите объект PK, когда нужен JavaScript: несколько последовательных действий, условия, циклы, промежуточные переменные или доступ к состоянию проекта из Скрипт-бокса.

Один проект может использовать оба способа. Например, адрес запроса может содержать выражение in-Line Kit, а Скрипт-бокс после ответа — читать результат разбора через объект PK и выполнять несколько действий на JavaScript.

Одна операция в двух формах записи

Оба примера ниже вычисляют MD5 для строки test. Результат одинаков: 098f6bcd4621d373cade4e832627b4f6.

Выражение записывается в поле проекта, где разрешена обработка in-Line:

(|MD5|test|MD5|)

Начальная круглая скобка запускает вычисление функции, а второй |MD5| закрывает её входные данные.

Как связаны два способа

in-Line Kit обрабатывает специальные записи вида |ИМЯ|...|ИМЯ| и переменные вида |LOGIN| или |PARS|[1]. Объект PK предоставляет те же данные и многие общие операции в JavaScript: например, PK.login, PK.getPars(1) и PK.md5(...).

Это не два отдельных вида проекта. Различается место записи:

выражение in-Line Kit находится непосредственно в поле проекта и возвращает текст для этого поля;
обращение к PK находится в JavaScript-коде Скрипт-бокса и возвращает значение, которое можно сохранить, проверить или передать следующему действию;
состояние принадлежит текущему запуску проекта, поэтому значение нужно читать в том месте выполнения, где оно уже было получено.

С чего начать

Если вы раньше не создавали проект, начните со справочника in-Line Kit: там показаны первая подстановка, переменные и порядок вычисления выражений. После этого откройте справочник объекта PK, если задаче нужен JavaScript или несколько связанных действий.

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