В SimpleOne запись – это базовая сущность для хранения и представления информации. Запись является контейнером (объектом), содержащим заполненные значения атрибутов таблицы, к которой она относится.
Информация в записях может иметь различный характер и назначение. Это могут быть как и просто пользовательские, транзакционные и исторические данные, так и конфигурационные данные, настройки системы. Например, записи, содержащие версионную информацию о конфигурации.
здесь должно быть изображение
С любой записью возможно взаимодействие как пользователя, так и процесса. Эти виды взаимодействия представлены операциями CRUD (создание, чтение, обновление, удаление).
Каждая такая операция представляет собой отдельную транзакцию. Транзакция – это упорядоченное множество действий, переводящих базу данных из одного согласованного состояния в другое. Согласованное состояние – это ожидаемое состояние актуальной информации, отраженное в базе данных.
Любая запись обладает набором полей, которые заполняются системой при создании и/или изменении записи:
- ID записи.
- Кем создано, Когда создано, Кем изменено, Когда изменено.
- В рамках наследования таблиц атрибут типа Record Class, предназначенный для обозначения таблицы, к которой относится определенная запись.
- Для записей конфигурационных данных, обязательными полями являются Политика и Приложение.
- Уникальный номер присваивается пронумерованным записям таблицы.
В SimpleOne взаимодействовать с записями можно через пользовательские интерфейсы, а также через различные API (серверное, REST).
Создание записи
В момент создания записи вы работаете с виртуальным объектом. Запись еще не существует до момента ее отправки в базу. При отправке такой записи в базу данных, стартует транзакция, результатом которой является появления реальной записи в базе данных.
При создании записи, когда требуется сформировать виртуальный объект, срабатывают правила контроля доступа (ACL), которые проверяют права пользователя на создание записей. Далее производится заполнение полей значениями по умолчанию, а уже в момент отправки записи в базу данных отрабатываются все механизмы, инициированные транзакцией. *ссылка на execution order
Новую запись через интерфейс можно создать несколькими способами:
- нажав Создать на представлении списка нужной таблицы.
- нажав Создать на форме записи нужной таблицы.
- нажав
на полях типа Reference, которые ссылаются на нужную таблицу.
- заполнив поля на уже созданной форме записи нужной таблицы другими значениями и создав копию записи.
Чтобы узнать, как создавать записи, используя API, обратитесь к статьям SimpleRecord или REST API.
Чтение записи
При чтении пользователю системы отдается доступное содержимое записи, т.е. атрибуты и их значения.
Эта операция не вызывает транзакций, связанных с изменением состояния записи. Правила контроля доступа (ACL) определяют доступность чтения всей записи, либо части ее содержимого.
Обновление записи
По сравнению с созданием, при обновлении записи вы также сначала работаете на основе виртуального временного объекта, который, в отличие от процедуры создания, заполнен на основе информации, содержащейся в базе данных. Для того чтобы информация была добавлена в базу данных, инициируется транзакция обновления, для которой справедливо все то же самое, что и для транзакции создания, кроме создания самой записи в базе данных.
На операцию обновления могут распространяться ограничения через правила контроля доступа (ACL). Также момент отправки записи в базу данных отрабатывает все механизмы, инициированные транзакцией. *ссылка на execution order
Удаление записи
При удалении информация о записи изымается из базы данных, а также в момент удаления отрабатывают все механизмы, инициированные транзакцией. *ссылка на execution order
Если вы хотите, чтобы можно было восстановить удаленные записи, активируйте Журнал удаления записей.
