Коллекции, поля и записи

Раздел Данные помогает работать с данными приложения как с понятными коллекциями. Вы видите поля, записи, поиск, фильтры и представления без технической настройки хранилища.

• Нужно хранить данные приложения в коллекциях.
• Нужно быстро посмотреть, добавить или изменить записи.
• Нужно дать команде понятный интерфейс для данных.

• Коллекция хранит один тип данных: например заявки, клиенты или заказы.
• Поле описывает значение записи: текст, число, дата, флажок или другой понятный тип.
• Запись — один элемент коллекции.
• Представление определяет, как вы смотрите на записи: таблица, галерея, доска, календарь или временная шкала.
• История структуры коллекций общая для проекта, но её версия применяется отдельно в Live, Preview и Dev. Сами записи также разделены между окружениями.

1. Создавать коллекции из понятных шаблонов.
2. Добавлять поля без ручной настройки технических имен. Заголовки полей и

кнопка добавления остаются доступны, даже если в коллекции пока нет записей. Новое поле можно сразу применить к текущему окружению или только создать миграцию для последующей синхронизации.

1. Искать и фильтровать записи.
2. Добавлять, редактировать и удалять записи, если у вас есть права.
3. Открывать запись в боковой панели для подробного просмотра.

Флажки включаются нажатием на подпись или клавишей Пробел, когда флажок в фокусе. Флажок в заголовке таблицы выбирает все загруженные записи; черта внутри него означает, что выбрана только часть записей. Недоступные флажки показывают значение, но не позволяют его менять.

В верхней строке находятся название коллекции, выбор представления и кнопка Добавить запись. В строке ниже — поиск, Фильтр, Сортировка и Поля. Число рядом с фильтром или сортировкой показывает количество активных условий.

Меню ⋯ справа в верхней строке называется Действия таблицы. В нём можно изменить Плотность строк табличного представления, открыть Импорт CSV, управлять представлениями и перейти к справке. Доступные действия зависят от ваших прав. В галерее, канбане, календаре и таймлайне здесь же находится Обновить.

В узкой рабочей области поиск занимает отдельную строку, а кнопка добавления подписана Запись. Значок рядом с названием представления обозначает его тип. Если открытая карточка записи сужает таблицу, список коллекций скрывается. Нажмите Открыть коллекции рядом с названием таблицы, чтобы выбрать другую коллекцию. После закрытия карточки список возвращается. Это работает и рядом с открытой панелью агента.

Поле Найти коллекцию слева ищет по названиям коллекций и папок. Поиск временный: он не меняет общую навигацию команды. Если папки не загрузились, доступные коллекции остаются в списке; нажмите Повторить, чтобы вернуть папки.

Нажмите номер записи или откройте её из карточного представления. На широком экране подробности появятся справа рядом с данными. Стрелки переключают загруженные записи текущего представления. Развернуть карточку открывает подробности в полном окне; Свернуть карточку возвращает боковую панель. Введённые значения при этом сохраняются. На телефоне карточка открывается поверх интерфейса и занимает экран.

После изменения полей нажмите Сохранить. При закрытии или переходе к другой записи с несохранёнными правками выберите Продолжить редактирование либо Не сохранять и продолжить. Ошибка сохранения сохраняет черновик для повторной попытки; ошибка удаления оставляет запись доступной. ID можно скопировать из раздела Технические данные; там же находятся служебные идентификаторы. Кнопка Удалить находится ниже полей и запрашивает подтверждение. В режиме просмотра доступны чтение, переходы и копирование ID, но нет изменения или удаления.

Фильтр, Сортировка и Поля открывают настройки рядом с нажатой кнопкой. Escape закрывает панель и возвращает фокус. Кнопка с иконкой агента справа от Поля разворачивает помощника и подготавливает контекст проекта, коллекции и окружения в сообщении. Допишите задачу и отправьте её; само открытие помощника ничего не меняет в данных.

Кнопка Структура данных внизу списка коллекций открывает состояние схемы выбранного окружения и план её изменений.

В Импорт CSV видны этапы файла, сопоставления полей и импорта. Во время создания структуры и добавления записей повторный запуск и закрытие недоступны. При ошибке файл и сопоставление остаются для исправления и повторной попытки.

1. Откройте нужную коллекцию в списке слева.
2. Нажмите название представления в верхней строке коллекции. В открывшемся

списке можно найти представление по названию или типу: Таблица, Галерея, Канбан, Календарь или Таймлайн.

1. Выберите найденное представление. Для работы с клавиатуры используйте

стрелки и Enter; Escape закрывает список без переключения.

1. Скопируйте адрес страницы, если хотите вернуться к той же коллекции,

представлению и окружению или открыть их в новой вкладке.

При переходе в другую коллекцию открывается её основное табличное представление. Если сохранённое представление удалили или вам закрыли к нему доступ, Agnostic безопасно откроет основное представление коллекции и обновит адрес. Режим Исходные данные доступен только администраторам и разработчикам; он не является общим представлением команды.

Любое представление занимает доступную высоту рабочей области. На небольшом экране прокручиваются записи, карточки, колонки или календарь внутри представления, а верхние действия и итоговая строка остаются на месте; сама страница при переключении вида не становится выше окна.

Администратор или разработчик может открыть меню Действия таблицы справа в верхней строке и:

• создать новое табличное представление;
• переименовать или дублировать текущее;
• переместить его выше или ниже в списке;
• сделать его основным для коллекции;
• удалить ненужное представление.

В табличном представлении общими для команды становятся фильтры, сортировка, скрытые поля, порядок и ширина колонок, а также плотность строк. Во время записи рядом с названием показано Сохранение…, после завершения — Сохранено. Поиск по записям не сохраняется: это временный запрос только для текущей вкладки.

Основное или последнее табличное представление удалить нельзя. Сначала создайте или выберите другое табличное представление, сделайте его основным, затем удалите старое. Удаление представления удаляет только его настройки — записи коллекции остаются.

Если представление одновременно изменил другой участник, Agnostic не перезапишет его настройки молча. Выберите Загрузить актуальное, чтобы отказаться от локальных изменений, или Сохранить как копию, чтобы оставить их в новом представлении.

Пользователь с доступом только на чтение может временно менять фильтры, сортировку, видимость и порядок полей, ширину колонок и плотность строк. Такие изменения видны только в его вкладке, не меняют общее представление и сбрасываются после повторного открытия.

Переключатель представлений доступен во всех проектах. При техническом откате версии сохранённые представления, их настройки и ссылки не удаляются и остаются доступны после восстановления сервиса.

В списке слева коллекции без папки находятся в разделе Без папки. Ниже показаны общие папки проекта, в том числе пока пустые. На узком экране откройте тот же список кнопкой Открыть коллекции в верхней строке.

Администратор или разработчик может:

• создать папку и позже переименовать её;
• перетащить коллекцию или папку мышью;
• открыть меню коллекции и выбрать Переместить в… — этот способ также

работает с клавиатуры и на сенсорном экране;

• переместить папку или коллекцию выше и ниже через меню;
• удалить папку после подтверждения.

Удаление папки не удаляет коллекции, поля, записи или представления. Все её коллекции переходят в Без папки и продолжают открываться по прежним ссылкам. Имена, состав и порядок папок общие для команды и не зависят от выбранного окружения. Свёрнутые разделы, напротив, запоминаются только в текущем браузере и не меняют вид списка у коллег.

Пользователь с доступом только на чтение видит папки и может сворачивать их, но не видит действий создания, переименования, перемещения и удаления. Если другой участник изменил порядок одновременно с вами, Agnostic вернёт последний сохранённый список: повторите перемещение после обновления.

Если создать, переименовать, удалить или переместить папку не удалось, появится краткое уведомление. Ошибка действия из окна также останется внутри него, чтобы можно было исправить название или повторить действие. Список папок обновится автоматически; отдельный постоянный блок ошибки над списком не показывается.

Папки доступны во всех проектах. При техническом откате версии папки, коллекции, записи, сохранённый состав и порядок не удаляются.

Новую командную доску можно подготовить через Agent: укажите коллекцию, окружение, название, поле статуса, заголовок и нужные поля карточки. После подтверждения откройте ссылку на доску в ответе. Сохранённые настройки доступны команде во всех окружениях проекта; записи и перемещения относятся к выбранному окружению. Agent сохраняет существующие виды и не делает новую доску основной.

Администратор или разработчик может открыть меню рядом с переключателем представлений и создать нужный вид. Для каждого вида Agnostic предложит только совместимые поля:

• Галерея — обязательное поле заголовка, при необходимости обложка и поля

описания.

• Канбан — обязательное поле группировки, при необходимости заголовок и

поля карточки.

• Календарь — обязательное поле даты или даты и времени, при необходимости

дата окончания и заголовок.

• Таймлайн — обязательная дата начала, при необходимости дата окончания,

группировка и заголовок.

Чтобы изменить активное представление, откройте то же меню и выберите Настроить представление. Настройки общие для команды. Если другой участник успел сохранить новую версию, ваши значения останутся в открытом окне и не перезапишут серверные данные. Нажмите Загрузить актуальное, проверьте свежие настройки и повторите изменение.

В этом же меню можно выбрать Переименовать или Удалить. Новое название сохранится для команды, но адрес представления не изменится. Перед удалением Agnostic откроет отдельное окно подтверждения. Удаляются только настройки выбранной галереи, канбана, календаря или таймлайна — записи коллекции остаются, а после подтверждения откроется основное табличное представление в том же окружении. Если представление уже изменил другой участник или запрос завершился ошибкой, окно останется открытым и покажет причину, чтобы действие можно было повторить безопасно.

Кнопка Обновить повторно загружает настройки и записи именно открытого представления. Если у коллекции несколько галерей, канбанов, календарей или таймлайнов, Agnostic не подменяет выбранный вид первым представлением того же типа. Поиск остаётся временным для текущей вкладки и не меняет общие настройки.

В канбане карточку можно перетащить или выбрать новую колонку в списке на карточке. В календаре используйте предыдущий и следующий месяц; событие можно перетащить на дату или открыть действие Переместить событие. В таймлайне можно менять масштаб и диапазон, перетаскивать элементы между группами либо выбирать новую дату и группу через действие Переместить элемент. Записи с одинаковыми датами в таймлайне располагаются в отдельных строках. Количество записей Без даты в календаре видно внизу. Перемещение изменяет запись только в выбранном окружении.

Пользователь с доступом только на чтение может открывать эти представления, обновлять их, менять месяц, диапазон и масштаб, но не видит настройки и действия перемещения. Если обязательного совместимого поля нет, создание вида будет недоступно с пояснением. Пустой результат и ошибка загрузки показываются внутри текущего представления; при ошибке можно повторить запрос.

Те же операции можно подготовить через подключённого локального агента. Агент не меняет Data самостоятельно: сначала он показывает безопасную сводку, а создание или изменение выполняется только после вашего подтверждения в браузере. После успеха агент получает актуальную схему коллекции и примеры Runtime SDK, не получая прямого доступа к хранилищу или raw-запросам.

Администратор или разработчик может попросить встроенного Agent: Свяжи клиентов и заявки: у клиента много заявок, удаление клиента с заявками запрети. Укажите окружение, таблицы и поле ссылки. Поле ссылки должно иметь тип ID, совместимый с единственным ключом целевой таблицы. Обязательность ссылки должна соответствовать существующему полю.

Перед подтверждением Agent показывает названия таблиц и поля, правило «много к одному», допустимость пустой ссылки и запрет удаления связанного объекта. Определение связи общее для проекта: в каждом окружении проверяются его собственные записи. После выполнения Agent повторно читает определение.

Создание этой связи доступно, пока таблица заявок пуста во всех окружениях. Если записи уже есть или появились до выполнения, Agent отказывает и сообщает о необходимости отдельного переноса и проверки ссылок. Он не переписывает заявки и не удаляет существующее правило. Проверки выполняет приложение; физическая структура таблиц этим действием не меняется.

Администратор или разработчик может попросить встроенного Agent: В Dev выгрузи все записи таблицы «События» в CSV, без обрезки. Укажите таблицу и окружение. Экспорт читает всю таблицу, независимо от выбранных строк и фильтров текущего представления, и не меняет записи.

В ответе появятся проверенное число записей и кнопка Скачать. CSV содержит технические имена колонок, идентификаторы записей и сохранённые значения всех полей. Файл использует UTF-8 и запятую как разделитель; пустые и отсутствующие значения отображаются пустыми ячейками. Значения select сохраняются как идентификаторы вариантов, сложные значения — как JSON.

Файл доступен только автору диалога при сохранении доступа к данным и экспорту. Он хранится час с момента создания; обновление страницы не сбрасывает этот срок. После истечения срока попросите Agent повторить экспорт. Результат не публикуется в Files и не передаёт все строки в переписку.

Для одного файла доступны до 10 000 записей и 8 МиБ. Если лимит превышен, доступ отозван или сервер не смог проверить все страницы и неизменность данных, Agent сообщит, что полный файл не сформирован. Частичная выгрузка не считается полным результатом.

Откройте меню коллекции в списке слева. Администратор или разработчик может:

• Переименовать — изменить только отображаемое название. Техническое имя,

ссылки, записи и представления останутся прежними.

• Дублировать структуру — создать новую коллекцию с теми же полями и

настройками полей. Записи и представления не копируются.

• Удалить — навсегда удалить общую коллекцию, все её записи и связанные

представления. Это действие нельзя отменить.

В окне удаления предупреждение сразу сопровождается кнопками Отмена и Удалить навсегда, без пустой секции между ними. Если удаление не удалось, сообщение об ошибке появится перед кнопками; окно останется открытым.

Если поле обязательно для галереи, канбана, календаря или таймлайна, удалить его сразу нельзя. В сообщении будут перечислены зависимые представления. Сначала выберите в них другое обязательное поле или удалите представления, а затем повторите удаление поля. Необязательные ссылки, фильтры и сортировки по удалённому полю очищаются автоматически.

Данные можно использовать в приложении, автоматизациях и Runtime SDK. Сложные сценарии выполняйте через код приложения или доверенные SDK-скрипты.

При переключении окружения вы увидите те же коллекции, но записи выбранного окружения. Agnostic не копирует данные между окружениями автоматически: тестовые записи из Preview или Dev не попадают в Live и наоборот.

Проверка структуры проходит в фоне: пока изменений нет, строка состояния не показывается и не занимает место над коллекциями. Если найдены недостающие изменения или ошибка, строка плавно появляется. Во время применения она показывает ход работы, а после успешного обновления скрывается.

Если в окружении не хватает изменений структуры, верхняя строка покажет их количество и кнопку Посмотреть изменения. В открывшемся окне изменения сгруппированы по коллекциям, а под заголовком указано выбранное окружение; раскройте нужную группу, чтобы увидеть её состав. Администратор или разработчик может применить изменения оттуда. Выполняются только недостающие изменения по порядку; записи из других окружений при этом не переносятся. Участник с доступом только для просмотра может изучить план, но не применить его.

При добавлении поля выберите одно из двух действий:

• Добавить и применить — поле сразу становится доступно в текущем

окружении.

• Создать миграцию — поле добавляется в общую историю структуры, но не

меняет текущее окружение. Чтобы начать использовать поле, нажмите Посмотреть изменения в верхней строке и примените план.

Если в окружении ещё нет самой коллекции, она помечена Не применено и не открывает записи. Если отстают только новые поля, существующие поля и записи остаются доступны: неприменённые поля временно скрываются, а фильтры и сортировка по ним возобновятся после обновления структуры.

При повторном открытии раздела Agnostic перепроверяет ранее обнаруженное расхождение базовой структуры. Если коллекции на самом деле ещё нет, она автоматически получит статус Не применено, и её можно будет создать через обычное применение изменений. Настоящее несовпадение структуры останется заблокированным для проверки администратором.

Если подтверждённое обновление было прервано временной недоступностью очереди, Agnostic восстановит задачу при следующем открытии раздела. Повторно подтверждать уже запущенный список изменений не требуется.

Если один шаг завершился ошибкой, строка состояния покажет Обновление структуры не завершено и сохранит причину в списке изменений. Остальные шаги перестанут отображаться как выполняющиеся. После исправления причины обычный план можно повторить. Если ошибка говорит об индексе, созданном старым способом, повторный запуск недоступен: передайте ошибку в поддержку для восстановления истории. Новые изменения индексов создавайте через план Data в CLI.

Если быстрое изменение поля было прервано между обновлением коллекции и сохранением истории, Agnostic подождёт завершения исходного запроса, а затем безопасно продолжит его. Уже применённое изменение не выполняется повторно. Если при этом не удалось подтвердить сохранение служебной истории, появится статус расхождения: администратор или разработчик сможет запустить восстановление синхронизации без повторного создания поля.

Публикация приложения или автоматизации в это окружение также ждёт актуальной структуры. Если показано расхождение или ошибка, не повторяйте изменения коллекции вручную — откройте подробности и передайте текст ошибки администратору.

При работе через агента пустой список новых изменений также может сопровождаться отставанием Dev: целевая структура уже описана, но ещё не применена. Агент должен подготовить новый план для выбранного окружения и выполнить ожидающие изменения. Повторное создание тех же полей не требуется. Подробнее: работа со схемой через MCP.