В SimpleOne запись – это базовая сущность для хранения и представления информации. Запись является контейнером (объектом), содержащим заполненные значения атрибутов таблицы, к которой она относится.
Информация в записях может иметь различный характер и назначение. Это могут быть как и просто пользовательские, транзакционные и исторические данные, так и конфигурационные данные, настройки системы. Например, записи, содержащие версионную информацию о конфигурации.
здесь должно быть изображение
В агентском интерфейсе работа с записями возможна в представлении формы или списка.
С любой записью возможно взаимодействие как пользователя, так и процесса. Эти виды взаимодействия представлены следующими операциями CRUD (: создание, чтение, обновление, удаление ).
Каждая такая операция представляет собой отдельную транзакцию. Транзакция – это упорядоченное множество действий, переводящих базу данных из одного согласованного состояния в другое. Согласованное состояние – это ожидаемое состояние актуальной информации, отраженное в базе данных.
Любая запись обладает набором полей, которые заполняются системой при создании и/или изменении записи:
- ID записи
- Кем создано, Когда создано, Кем изменено, Когда изменено
- В рамках наследования таблиц атрибут типа Record Class, предназначенный для обозначения таблицы, к которой относится определенная запись.
- Для записей конфигурационных данных, обязательными полями являются Политика и Приложение.
- Уникальный номер присваивается пронумерованным записям таблицы.
В SimpleOne взаимодействовать с записями можно через пользовательские интерфейсы, а также через различные API (серверное, REST).
Создание записи
В момент создания записи вы работаете с виртуальным объектом. Запись еще не существует до момента ее отправки в базу. При отправке такой записи в базу данных, стартует транзакция, результатом которой является появления реальной записи в базе данных.
При создании записи, когда требуется сформировать виртуальный объект, срабатывают правила контроля доступа (ACL), которые проверяют права пользователя на создание записей. Далее производится заполнение полей значениями по умолчанию, а уже в момент отправки записи в базу данных отрабатываются все механизмы, инициированные транзакцией. *ссылка на execution order
(CRUD операции). В зависимости от настроек правил контроля доступа (ACL), можно ограничить доступ некоторым пользователям или группам пользователей к выполнению CRUD операций.
Создание записи
Новую запись в агентском интерфейсе
Новую запись через интерфейсможно создать несколькими способами:
- нажав Создать на представлении списка нужной таблицы.
- нажав
- Создать на форме любой записи нужной таблицы.
- нажав Создать запись на форме настройки нужной таблицы.
- нажав
-
на полях типа Reference, которые ссылаются на нужную таблицу. - заполнив поля
- уже созданной
- записи нужной таблицы другими значениями и создав копию записи.
| Note |
|---|
Размер создаваемой записи не должен превышать 2.5 Mбайт.
|
Чтение записи
При чтении пользователю системы отдается доступное содержимое записи, т.е. атрибуты В зависимости от предоставленного пользователю доступа, он может просматривать доступные атрибуты записи и их значения.
Эта операция не вызывает транзакций, связанных с изменением состояния записи. Правила контроля доступа (ACL) определяют доступность чтения всей записи, либо части ее содержимого.
Обновление записи
По сравнению с созданием, при обновлении записи вы также сначала работаете на основе виртуального временного объекта, который, в отличие от процедуры создания, заполнен на основе информации, содержащейся в базе данных. Для того чтобы информация была добавлена в базу данных, инициируется транзакция обновления, для которой справедливо все то же самое, что и для транзакции создания, кроме создания самой записи в базе данных.
На операцию обновления могут распространяться ограничения через правила контроля доступа (ACL). Также момент отправки записи в базу данных отрабатывает все механизмы, инициированные транзакцией. *ссылка на execution order
Удаление записи
При удалении информация о записи изымается из базы данных, а также в момент удаления отрабатывают все механизмы, инициированные транзакцией. *ссылка на execution order
Обновление записи
Чтобы обновить запись в агентском интерфейсе, измените значение в необходимых полях на форме и нажмите Сохранить. Также пользователи с ролью admin могут редактировать записи при помощи встроенного редактирования.
Удаление записи
Удалить запись в агентском интерфейсе можно одним из следующих способов:
- В представлении списка таблицы, содержащей записи, которые нужно удалить:
- выберите нужные записи, установив флажки слева от них.
- нажмите Удалить в правом верхнем углу.
- Выбрав Удалить в бургер-меню записи, которую нужно удалить.
| Tip |
|---|
Удаленные записи можно восстановить из Журнала удаления записей (sys_record_deletion_log), если на форме таблицы, к которой относится удаленная запись, установлен флажок Логировать удаление записей. |
Уникальный идентификатор записи
Каждая запись в экземпляре определяется уникальным 18-символьным идентификатором (ID), который называется sys_id. ID записи должен быть уникальным в пределах одной таблицы (включая записи в родительских и дочерних таблицах). Значение ID записи не может быть изменено.
ID записи можно получить из URL-адреса записи. Например, запись статьи с URL, как в приведенном ниже примере, имеет ID 158815469913225806.
| Code Block | ||||
|---|---|---|---|---|
| ||||
https://<instance_url>/record/article/158815469913225806 |
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|