Места встройки приложений в интерфейсе портала

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

• Шапка (Header): приложение может добавить в верхнюю панель портала свою иконку или кнопку . Например, это может быть индикатор уведомлений приложения или значок, открывающий меню с командами приложения. При клике по такому элементу может показываться выпадающее окно (dropdown) с информацией или действиями от приложения. Если приложение интегрируется в шапку, после установки его значок автоматически появляется в выделенной области (с подсказкой при наведении курсора).
• Главное меню (Menu): приложение может добавить свой пункт в левом навигационном меню Аспро.Cloud. Это может быть либо новый раздел верхнего уровня (например, пункт с названием приложения или раздел “Приложения компании”), либо элемент внутри существующего раздела (например, в разделе CRM подменю “Приложения”). При выборе этого пункта меню в центральной области открывается интерфейс самого приложения (его страница или раздел) . Платформа автоматически управляет видимостью этих пунктов: их видят только те пользователи, которым разрешён доступ к приложению (администраторы или назначенные роли) . Меню динамически обновляется – установка нового приложения сразу добавляет пункт, удаление – убирает, без перезапуска всего портала .
• Вкладки (Tabs): приложения могут добавлять новые вкладки в интерфейсе существующих объектов или страниц платформы . Например, в карточке сделки CRM по умолчанию есть вкладки “Обзор”, “История” и т.д. Установленное приложение может добавить туда свою вкладку, например “Аналитика X”, которая покажет дополнительную информацию или функциональность из приложения . В манифесте указывается, к какому типу сущностей привязывается вкладка (сделка, проект, задача, клиент и т.д.) и уникальный идентификатор вкладки. Платформа будет отображать эту вкладку только если приложение установлено и у пользователя есть к нему доступ . Важно: система следит за уникальностью – две разных приложения не могут добавить вкладки с одинаковым именем к одному объекту, это проверяется при установке .
• Карточки/виджеты (Cards): под «карточками» понимаются небольшие информационные блоки, которые приложение может выводить в разных местах интерфейса . Например, на доске задач может отображаться дополнительная карточка с метрикой от приложения (график, число), либо на странице отчётов – кастомный блок с данными из внешней системы . Такие виджеты могут быть разных размеров (от небольших информеров до полноразмерных блоков). Приложение встраивает их через манифест (раздел cards), указав, куда именно добавляется виджет (например, в карточку клиента CRM или на доску задач) и какой контент в нём отображается. Дашборд пользователя технически тоже состоит из таких карточек, но о нём – отдельно ниже. Платформа предоставляет API, с помощью которого приложение может обновлять содержимое своих виджетов в реальном времени (например, отправив обновлённые данные по веб-сокету, чтобы график на карточке перерисовался) . Примеры виджетов: интеграция с сервисом погоды может отображать карточку “Текущая погода” прямо в портале; финансовое приложение – карточку с текущим балансом или курсом валют . Пользователь может самостоятельно располагать эти карточки: например, перенести на свой рабочий стол (дашборд) или скрыть, если не нужны, в рамках настроек интерфейса.
• Отчёты (Reports): приложение может регистрировать новый тип отчёта или диаграммы внутри модуля отчетов Аспро.Cloud . Допустим, в базовой системе отчёты охватывают проекты, продажи, задачи; приложение же может добавить свой раздел – например, “Отчёт по X”, где X – данные из стороннего сервиса или нестандартная аналитика. После установки приложения новый тип отчёта появляется в списке доступных отчетов для пользователя . При построении такого отчёта платформа либо запрашивает необходимые данные у приложения через его API, либо приложение само заложило формулы вычисления в своём коде. Формат данных отчёта стандартизирован – приложение возвращает JSON с таблицами, наборами данных, а также определяет схемой, как визуализировать эти данные (например, какие графики построить) . Права доступа также учитываются: новый отчёт видят только пользователи соответствующих ролей (финансовые отчёты – финансисты, и т.п.) .
• Рабочий стол (Dashboard): это главный экран (дашборд) пользователя, где показана сводная информация: задачи, графики, ключевые показатели. Приложения могут добавлять на рабочий стол свои виджеты, аналогичные описанным выше карточкам . Разница в том, что эти виджеты относятся именно к главному экрану. В манифесте приложение указывает, что у него есть интеграция в dashboard, задаёт тип и размер виджета, и предоставляет данные для отображения . После установки приложения пользователь в настройках рабочего стола может включить отображение этого виджета (если он не включён автоматически). Платформа будет поддерживать обновление таких виджетов (либо периодическим опросом, либо push-уведомлениями от приложения) и сможет одновременно показывать виджеты от нескольких приложений без ущерба производительности .
• Мобильное приложение: Аспро.Cloud имеет собственный мобильный клиент, и приложения маркетплейса также могут интегрироваться в него. Если приложение поддерживает мобильный режим, в манифесте это отмечается (например, флаг или раздел mobile) . Тогда после установки, соответствующие элементы приложения появятся и в мобильном интерфейсе: например, свой пункт в навигационном меню мобильного приложения, ведущий на экран приложения, или виджет на мобильном дашборде . Технически мобильная интеграция обычно реализуется через WebView: Аспро.Cloud открывает адаптивную веб-страницу приложения внутри мобильного клиента, передавая контекст (токен пользователя и др.) . Если приложение не рассчитано на мобильное использование (нет адаптивного UI), то мобильный клиент Аспро.Cloud скроет его элементы или сообщит пользователю, что функциональность доступна только на десктопе . Разработчикам рекомендуется предусматривать хотя бы базовую мобильную поддержку, чтобы приложение было доступно широкой аудитории.

Каждая из перечисленных точек интеграции реализована модульно: платформа регистрирует обработчики, которые при установке приложения читают соответствующие разделы его манифеста и автоматически “встраивают” приложение в нужные места интерфейса . Такой подход облегчает масштабирование – со временем могут появляться новые точки встройки (например, интеграция в таймлайн активности CRM или в новый модуль), и их добавление потребует только обновления схемы манифеста и добавления нового обработчика, без переработки существующей архитектуры .

Таким образом, разработчики Аспро.Cloud-приложений получают гибкие инструменты для расширения всех основных частей портала – от UI до данных – при строгом соблюдении стандартов безопасности и качества платформы. Следуя данным базовым знаниям и руководству по JSON-манифесту, вы сможете создать собственное встроенное приложение и успешно опубликовать его в маркетплейсе Аспро.Cloud.