В SimpleOne запись – это базовая сущность для хранения и представления информации. Запись представляет собой контейнер атрибутов с заполненными значениями, которые могут быть различных типов данных. Каждый атрибут этого контейнера также имеет свои атрибуты.
Информация в записях может носить разный характер. Это могут быть как и просто пользовательские данные, так и конфигурационные данные, настройки системы. Например, VCS записи.
таблица<- запись<- поле<- значение полей
В агентском интерфейсе работа с записями возможна в представлении формы или списка.
С любой записью возможно взаимодействие как пользователя, так и процесса. Эти виды взаимодействия представлены следующими операциями: Все записи в системе между собой взаимодействуют. Эти виды взаимодействия представлены операциями CRUD ( создание, чтение, обновление, удаление ).
Каждая операция представляет собой транзакцию. Транзакция – это упорядоченное множество операций, переводящих базу данных из одного согласованного состояния в другое. Согласованное состояние – это состояние, которое подходит под бизнес-логику системы.
У каждой записи есть набор полей, который является обязательным для создания записи:
- ID записи
- Кем создано, Когда создано, Кем изменено
- В рамках наследования таблиц атрибут типа Record Class, предназначенный для обозначения таблицы, к которой относится определенная запись.
- Для записей конфигурационных данных, обязательными полями являются Политика и Приложение.
В SimpleOne взаимодействовать с записями можно через интерфейс, а также через API (Серверное, REST).
Создание записи
При создании записи вы работаете с виртуальным объектом. Запись еще не существует до момента ее отправки в базу. После отправки в транзакцию и появления в базе, виртуальный объект становится реальным.
До создания записи отрабатываются только значения по умолчанию и правила контроля доступа (ACL).
(CRUD операции). В зависимости от настроек правил контроля доступа (ACL), можно ограничить доступ некоторым пользователям или группам пользователей к выполнению CRUD операций.
Создание записи
Новую запись в агентском интерфейсе
Новую запись через интерфейсможно создать несколькими способами:
- нажав Создать на представлении списка нужной таблицы.
- нажав
- Создать на форме любой записи нужной таблицы.
- нажав Создать запись на форме настройки нужной таблицы.
- нажав
на полях типа Reference, которые ссылаются на нужную таблицу. - заполнив поля
- уже созданной
- записи нужной таблицы другими значениями и создав копию записи.
| Note |
|---|
Размер создаваемой записи не должен превышать 2.5 Mбайт.
|
Чтение записи
При чтении пользователю системы отдается содержимое записи.
Эта операция не является транзакцией, а также на нее могут распространяться ограничения через правила контроля доступа (ACL).
Обновление записи
По сравнению с созданием, при обновлении записи обновляется временный объект. Временный объект создан на основе копии записи, хранящейся в базе. Когда мы обновляем временный объект, он отправляется в транзакцию, чтобы далее он появился в базе.
На операцию обновления могут распространяться ограничения через правила контроля доступа (ACL).
Удаление записи
При удалении информация о записи изымается из базы.
В зависимости от предоставленного пользователю доступа, он может просматривать доступные атрибуты записи и их значения.
Обновление записи
Чтобы обновить запись в агентском интерфейсе, измените значение в необходимых полях на форме и нажмите Сохранить. Также пользователи с ролью 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 | ||||||
|---|---|---|---|---|---|---|
|