# ToolS

Kernel tools, not mentioned in Setup

## Search

### Setup

#### Forms

Using permission options you can restrict the shown forms, or set the default one.

The application kernel provides forms: customer, process. Additional forms are provided by following plugins:

- FullText - full-text search for kernel entities, fulltext form;

- BGBilling - search over entities in the billing system, bgbilling-searchContract form.

### Usage

#### Customer

Оснастка позволяет осуществлять поиск всех сущностей в системе. Для поиска необходимо нажать Enter в поле с параметром поиска, либо в поле Квартира для адресного параметра (можно оставить пустым). При поиске по адресу доступен контекстный поиск улиц и домов.

Ядро предоставляет поиск контрагентов по адресу, наименованию, коду. Для поиска по наименованию необходимо набрать подстроку наименования и нажать Enter. Для поиска по коду - ввести точный код контрагента и нажать Enter. При поиске контрагента по наименованию возможен дополнительный вывод описывающих его параметров, что задаётся в конфигурации.

При поиске по адресу осуществляется поиск по всем адресным параметрам контрагентов. В результатах поиска отображается наименование контрагента, наименование параметра и значение. Возможен поиск как только по улице: выбрать улицу в контекстном поиске и нажать Enter; так и по Улице + Дому или Улице + Дому + Квартире - Enter нажимается в последнем заполненном поле.

#### Process

##### By ID

Process can be found by ID.

##### The Current User Related

The current user related processes may be listed:

- Created by me - created by the current user;

- Closed by me - closed by the current user;

- Status changed by me - the last status change is performed by the current user.

Sorting has been done by ascending of creation, closing or status changing time respectively. Result examples are presented on the screens below.

##### Param

Supported process search by text parameter values.

## Session Log

This important tool is available in Log menu and allows collecting session logs, which may be requested by developers.

Once enabled the tool is collecting logs starting from DEBUG level for the current user session only, that allows easier observe possible problems.

The log is refreshed any time when it is opened back.

## News

The News provide built-in notification system, allowing to send messages over application’s users.

### Setup

To mark news read by timeout or delete them, for scheduler have to be configured running class News once a day.

### Usage

News may be listed and added via a separated tool. Every news can be read once by every recipient, by default only unread news are shown.

When adding a news, you have to define a title and text, which can contain HTML markup. News recipients can be restricted from all active users to only members of groups, selected in the right area.

A news can be defined as Popup or Regular. The first type is shown for all targeted recipients in popping up windows, after that is treated as read.

Regular news do not bother users else as with blinking counter of unread messages in the top right corner.

Clicking on that brings the user to the list of unread news.