Skip to main content

Миграция с 7.22 на 7.23

Изменения в сборке​

  • Добавлена поддержка Java 17
  • Версия Spring Boot повышена до 2.5.12

Изменения в XML API​

  • Упразднены устаревшие схемы: page-2.0, region-1.0

  • Добавлены новые схемы: application-3.0 и query-5.0.

  • Атрибуты ref-page полей и target-page действия <copy> упразднены с сохранением обратной совместимости. Атрибут target-page-id действий show-modal / open-drawer был удален. Для обращения к источнику данных родительской страницы рекомендуется использовать <parent-datasource>.

  • Атрибуты visibility-condition и enabling-condition упразднены.

  • Упразднено действие <perform>. Вместо него необходимо использовать действие <action>.

  • Свойство default-values-query-id у виджетов в page-3.0 больше не поддерживается, если необходим такой функционал, следует использовать default-values-mode="merge" у datasource в page-4.0.

Переход на application-3.0​

  • Необходимо перенести элемент <sidebar> во внутрь элемента <sidebars>. Таким образом добавлена поддержка нескольких <sidebar>, отображающихся в зависимости от url страницы, который должен соответствовать атрибуту path.

Пример как работало в схемах application-1.0 и application-2.0

<?xml version='1.0' encoding='UTF-8'?>
<application xmlns="http://n2oapp.net/framework/config/schema/application-1.0">
    <sidebar src="test" class="test"
            title="Test Sidebar" home-page-url="http://google.com/">
        <nav ref-id="testMenu"/>
    </sidebar>
</application>

Пример как работает в схеме application-3.0

<?xml version='1.0' encoding='UTF-8'?>
<application xmlns="http://n2oapp.net/framework/config/schema/application-3.0">
    <sidebars>
        <sidebar path="/home"
                 src="home" class="home"
                 title="Home Sidebar" home-page-url="http://google.com/">
            <nav ref-id="homeMenu"/>
        </sidebar>
        <sidebar path="/profile"
                 src="profile" class="profile"
                 title="Profile Sidebar">
             <nav ref-id="profileMenu"/>
        </sidebar>
    </sidebars>
</application>

Переход на query-5.0​

  • Все фильтры полей необходимо вынести в новый тэг <filters>, указав при этом в атрибуте field-id фильтра значение идентификатора поля, соответствующего данному фильтру.

Пример как работало в схеме query-4.0

<?xml version='1.0' encoding='UTF-8'?>
<query xmlns="http://n2oapp.net/framework/config/schema/query-4.0">

    <fields>
        <field id="id">
            <select/>
            <filters>
                <eq filter-id="id"/>
            </filters>
        </field>
        <field id="name">
            <select/>
            <filters>
                <eq filter-id="nameEq"/>
                <like filter-id="nameLike"/>
            </filters>
        </field>
    </fields>
</query>

Пример как работает в схеме query-5.0

<?xml version='1.0' encoding='UTF-8'?>
<query xmlns="http://n2oapp.net/framework/config/schema/query-5.0">
    <!-- фильтры вынесены отдельно от полей -->
    <!-- для привязки к полю укажите field-id -->
    <filters>
        <eq field-id="id" filter-id="id"/>
        <eq field-id="name" filter-id="nameEq"/>
        <like field-id="name" filter-id="nameLike"/>
    </filters>

    <fields>
        <field id="id"/>
        <field id="name"/>
    </fields>
</query>
  • Атрибуты mapping, default-value и normalize элемента <select> необходимо перенести в <field>. Тело элемента <select> переносится в атрибут select-expression.
note

В новой схеме все поля по умолчанию участвуют в выборке. Поэтому во всех элементах <field> с отсутствующим тегом <select> необходимо прописать select="false".

После указанных преобразований элемент <select> должен быть удален из поля.

Пример как работало в схеме query-4.0

<?xml version='1.0' encoding='UTF-8'?>
<query xmlns="http://n2oapp.net/framework/config/schema/query-4.0">

    <fields>
        <field id="personName">
            <select mapping="['name']" default-value="unknown" normalize="#this.toUpperCase()">name: $$name</select>
        </field>
        <!-- поле не участвует в выборке -->
        <field id="personAge"/>
    </fields>
</query>

Пример как работает в схеме query-5.0

<?xml version='1.0' encoding='UTF-8'?>
<query xmlns="http://n2oapp.net/framework/config/schema/query-5.0">

    <fields>
        <field id="personName" mapping="['name']" select-expression="name: $$name"
                    default-value="unknown" normalize="#this.toUpperCase()"/>
        <!-- поле не участвует в выборке (задан select="false") -->
        <field id="personAge" select="false"/>
    </fields>
</query>
  • Значение атрибута mapping элемента <sorting> переносится в атрибут sorting-mapping тега <field>. Тело элемента <sorting> переносится в атрибут sorting-expression.
note

В новой схеме все поля по умолчанию не являются сортируемыми (как и раньше). Поэтому во всех элементах <field> с указанным тегом <sorting> необходимо прописать sorting="true".

После указанных преобразований элемент <sorting> должен быть удален из поля.

Пример как работало в схеме query-4.0

<?xml version='1.0' encoding='UTF-8'?>
<query xmlns="http://n2oapp.net/framework/config/schema/query-4.0">

    <fields>
        <field id="name">
            <sorting/>
        </field>
        <field id="price" domain="integer">
            <sorting mapping="['price']">$$price: price</sorting>
        </field>
    </fields>
</query>

Пример как работает в схеме query-5.0

<?xml version='1.0' encoding='UTF-8'?>
<query xmlns="http://n2oapp.net/framework/config/schema/query-5.0">

    <fields>
        <field id="name" sorting="true"/>
        <field id="price" domain="integer" sorting="true" sorting-mapping="['price']" sorting-expression="$$price: price"/>
    </fields>
</query>
  • Также в новой схеме введена возможность задавать иерархию полей с помощью элементов <field>, <reference>, <list>. Группы полей, использующих точку в mapping элемента <select> (или по умолчанию в идентификаторе), например mapping="['employee.name']" и mapping="['employee.age']" или id="cars.id" и id="cars.price" можно задавать как <reference> и <list> поля.

Пример как работало в схеме query-4.0

<?xml version='1.0' encoding='UTF-8'?>
<query xmlns="http://n2oapp.net/framework/config/schema/query-4.0">

    <fields>
        <field id="readerId">
            <select mapping="['reader.id']"/>
        </field>
        <field id="readerEmail">
            <select mapping="['reader.email']"/>
        </field>
        <field id="booksTitle">
            <select mapping="['reader.books.title']"/>
        </field>
        <field id="booksAuthor">
            <select mapping="['reader.books.author']"/>
        </field>
    </fields>
</query>

Пример как работает в схеме query-5.0

<?xml version='1.0' encoding='UTF-8'?>
<query xmlns="http://n2oapp.net/framework/config/schema/query-5.0">

    <fields>
        <reference id="reader" mapping="['reader']">
            <field id="readerId" mapping="['id']"/>
            <field id="readerEmail" mapping="['email']"/>
            <list id="books" mapping="['books']">
                <field id="booksTitle" mapping="['title']"/>
                <field id="booksAuthor" mapping="['author']"/>
            </list>
        </reference>
    </fields>
</query>
  • В query-5.0 упразднены дочерние элементы <expression> и <join> тега <fields>.

Изменения в сборке Frontend​

Удалены модули

  • n2o-auth - содержимое перенесено в n2o-framework/core/auth/
  • n2o-notifications - содержимое перенесено в n2o-framework/sagas/notifications/
  • n2o-ecp-plugin

Изменения в Java API​

  • Метод setCriteriaResolver класса N2oQueryProcessor был переименован в setCriteriaConstructor.
  • Изменилась сигнатура метода buildSuccessMessage класса класса AlertMessageBuilder: buildSuccessMessage(String, RequestInfo, DataSet) -> buildSuccessMessage(ActionRequestInfo<DataSet>, DataSet)
  • Классы из пакета net.n2oapp.framework.api.metadata.event.action.* перемещены в пакет net.n2oapp.framework.api.metadata.action.*.
  • Класс net.n2oapp.framework.api.metadata.application.Event перемещен в пакет net.n2oapp.framework.api.metadata.meta.event.Event

Изменения в API автотестов​

  • Интерфейс Dropdown переименован в Expandable
  • Метод tooltip был перемещен из интерфейса Page в интерфейсы, использующих его компонентов (StandardButton, IconCell, TooltipListCell)
  • Методы expand \ collapse компонентов DateInput, DateInterval, Select, InputSelect, TimePicker, InputSelectTree объявлены deprecated. Вместо них рекомендуется использовать методы openPopup \ closePopup
  • В автотестах теперь необязательно указывать application.xml файл, если он не используется явно. Как следствие этого, файл net/n2oapp/framework/autotest/blank.application был удален. Если он использовался в ваших автотестах, то необходимо удалить его из тестовых классов.
  • Обращение к алертам через page.alerts().alert(0) объявлено deprecated. Рекомендуется использовать следующий вызов page.alerts(Alert.Placement.top).alert(0).
  • Методы clickLink \ firstTitleShouldHaveText \ titleShouldHaveText \ titleByIndexShouldHaveText компонента Breadcrumb объявлены deprecated. Для обращения к хлебным крошкам рекомендуется использовать следующий вызов page.breadcrumb.crumb(0).