From 1167a17fbaf56c5a8c9553872a7f09f568eda2c4 Mon Sep 17 00:00:00 2001
From: Daniel Slapman <danslapman@gmail.com>
Date: Wed, 11 Jan 2023 16:42:08 +0100
Subject: [PATCH] Update readme

---
 backend/project/Settings.scala |  2 +-
 readme.md                      | 19 ++++++++++++++++++-
 2 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/backend/project/Settings.scala b/backend/project/Settings.scala
index c19bc1e2..0e5133ff 100644
--- a/backend/project/Settings.scala
+++ b/backend/project/Settings.scala
@@ -26,7 +26,7 @@ object Settings {
 
   val common = Seq(
     organization := "ru.tinkoff",
-    version := "3.3.0",
+    version := "3.4.0",
     scalaVersion := "2.13.10",
     Compile / packageDoc / publishArtifact := false,
     Compile / packageSrc / publishArtifact := false,
diff --git a/readme.md b/readme.md
index 74a42d36..bd5e9854 100644
--- a/readme.md
+++ b/readme.md
@@ -119,7 +119,7 @@ State аккумулятивно дописывается. Разрешено п
 * `req` - тело запроса (режимы json, jlens, xpath)
 * `message` - тело собщения (в сценариях)
 * `query` - query параметры (в заглушках)
-* `pathParts` - значения, извлекаемые из URL (в заглушках)
+* `pathParts` - значения, извлекаемые из URL (в заглушках) см. `Экстрация данных из URL`
 * `extracted` - извлечённые значения
 * `headers` - HTTP заголовки
 
@@ -131,6 +131,23 @@ State аккумулятивно дописывается. Разрешено п
   "d": "${req.fieldA}: ${state.a}" //В поле d запишется строка, содержащая req.fieldA и state.a
 }
 ```
+
+## Поиск state
+
+Предикаты для поиска state перечисляются в блоке `state`. Пустой объект (`{}`) в поле state недопустим.
+Для поиска state можно использовать данные запроса (без префикса), query параметры (префикс `__query`) и значения, извлекаемые из URL (префикс `__segments`) 
+
+Пример:
+
+```javascript
+{
+  "_a": "${fieldB}", //поле из тела запроса
+  "_b": "${__query.arg1}", //query параметр
+  "_c": "${__segments.id}" //сегмент URL, см. `Экстрация данных из URL`
+}
+```
+
+
 ## Seeding
 
 Иногда возникает необходимость сгенерировать случайное значение и сохранить и/или вернуть его в результате работы мока.