Для работы с магазинов виджетов достаточно браузера. Интерфейс магазина предполагает работу пользователей на рабочей станции с разрешением не ниже 1920x1080). Интерфейс не поддерживает работу на мобильных устройствах.
Для входа в магазин новому пользователю необходимо получить у администратора логин/пароль.
- Администратор - управляет пользователями. Плюс права тестировщика и разработчика.
- Тестировщик - может переводить статус реализации из тестирования в эксплуатацию.
- Разработчик - добавляет виджеты и реализы виджетов.
- Пользователь - пользователь системы.
- Пользователь может видеть список всех виджетов.
- Пользователь может видеть детали одного виджета (описание, тэги, список реализаций).
- Разработчик может добавлять новые виджеты, при этом они становятся доступными для
редактирования только ему (становятся «его» виджетами).
- Разработчик может удалить виджет, если он не имеет ни одной реализации в статусе
публичной доступности. При удалении виджета, все реализации виджетов также удаляются.
- Разработчик может редактировать метаданные виджетов, которые он добавил сам (его виджеты).
- Разработчик может добавить своему виджету произвольное количество разных тэгов.
- Разработчик может удалить реализацию своего виджета (если он не имеет статуса
публичной доступности). Удаляется метаданные и файлы.
- Разработчик может добавить новую реализацию виджета (загрузить новый zip архив). При добавлении новая реализация виджета имеет сброшенный признак публичного доступа (т.е. не доступна для использования).Также при добавлении новая реализация имеет сброшенный признак нарушения обратной
совместимости (т.е. считается обратно совместимой). (пока всегда).
- Тестировщик может переводить статус реализации из тестирования в эксплуатацию.
- Администратор может видеть список пользователей.
- Администратор может видеть детали одного пользователя.
- Администратор может добавлять нового пользователя.
- Администратор может давать/забирать роли у пользователя.
Если у учетной записи забрали роль разработчик, он теряет возможность менять свои виджеты.
При логине пользователя в магазин загружается список всех виджетов в магазине.
Для каждого виджета доступны следующие действия:
- загрузить список релизов виджета;
- выполнить экпорт виджета;
- удалить виджет;
- выполнить импорт нового виджета;
- создать новый виджет.
Ниже описаны основные операции, доступные пользователям магазина, с учетом их роли.
Нажать Add widget. В окне ввести данные нового виджета:
- имя виджета;
- описание виджета.
По умолчанию новый виджет создается с новым GUID от системы, но если пользователь хочет ввести свой GUID, при отключении генерации GUID появляется строка для ввода GUID. Это уникальный идентификатор виджета, поэтому , при его вводе в ручную слдеует учитывать этот факт.
После заполнения всех полей нажать Add widget*.
Нажать Import widget. В окне выбрать файл с новым релизом виджета.
Если в магазине уже есть опубликованный релиз виджета с идентификатором, который совпадает с импортируемым, то такой виджет не загрузится.
Если структура файла не соответствует структуре виджета - такой файл не будет загружен.
Нажать Releases - загрузится список релизов виджета. На форме релизов виджета доступны следующие действия:
- создать новый релиз виджета;
- удалить релиз виджета, если он не был опубликован;
- опубликовать релиз;
- изменить мета информацию о виджете: GUID, имя, описание.
При создании нового релиза,требуется загрузить zip с виджетом, подготовленный согласно руководству программиста.
Может возникнуть ситуация, когда виджет создан с новым GUID, не совпадающим с GUID этого виджета в магазине. Обычно такая ситуация типична при экспорте-импорте виджетов между магазинами. При различии в GUID-ах, релиз нового виджета не создаться.В этом случае следует выполнить следующие действия:
- переименовать виджет в магазине;
- выполнить удаление виджета в магазине;
- выполнить импорт нового экземпляра виджета.
При операции публикации релиза виджета,. новая версия виджета становится доступна инстансам.
Все инстансы, которые использовали удаленный GUID виджета так и будут полцчать код этого виджетов. Дашборды не сломаются. Но, новым экземпляром дашбордов будет доступен новый релиз виджета.
Экпорт виджета всегда выгружает последний релиз. GUID и версия релиза виджета указана в файле package-info.json. Операция экспорта и импорта удобна для перемещения виджетов между разными магазинами, например тестовый и продуктовый, поскольку сохраняются GUID и номера версий, и достаточно просто становится сопровождать релизы в разных магазинах.
Для экспорта следует нажать кнопку Export, произойдет выгрузка zip файла.
Удаление виджета производится по кнопке Delete. После подтверждения операции, удаляется виджет и все го релизы.
Следует помнить, что удаление виджета может не приведет к ошибкам на дашбордах в инстансе, но виджет перестанет быть доступен на истансах.
Действия с пользователями доступно только роли Администратор. Следует выбрать в меню пункт Users. Загрузится список пользователей, с указанием их роли, LastName, FirstName.
Администратору доступны следующие действия:
- заблокировать пользователя;
- изменить роль пользователя;
- изменить пароль пользователя;
- добавить нового польльзователя.
Список пользователей должен содержать также учетные записи, которые используются истансами платформы при считывании виджетов для загрузки их на дашборды. Таким пользователям достаточно роли Пользователь. Инстансы обращаются к магазину только для чтения данных.
Раздел Forge Autodesk доступен только пользователю с правами Администратор. Раздел предоставляет возможность отправить Revit модель в сервис Forge Autodesk и получить токен на подготовленный экземпляр модели для ее представления в виджете Autodesk 3D.
Основные ограничения:
- Поддерживаются только модели Autodesk Revit
- Все модели обрабатыватся и хранятся в облачном сервисе AutoDesk Forge, доступ к которым имеет только компания Inspark.
- При длительном времени не использования модели, сервис Autodesk Forge может применить политики очистки хранилища от неиспользуемых моделей.
- Платформа Inspark не хранит Revit и обработанные модели 3D. На момент загрузки виджета Autodesk 3D, сервис Forge должен быть доступен для загрузки 3D модели.
Порядок действий:
- Создать папку (Add bucket). Папка создается в хранилище Forge.
- Загрузить модель. При загрузке модели , имя модели вводите только на латинице в нижнем регистре (требования forge-сервиса). Если при загрузке модели не задавать имя конкретного инстанса платформы, то эта модель будет доступна на всех инстансах платформы, которые использет этот магазин. Если задать имя инстанса, то модль будет доступна только в указанном инстансе.
- Сервис Autodesk Forge может некоторое время обрабатывать модель и не сразу выдать токен. По окончании обработки выдается строчка токена обработанной модели, которая будет использоваться в виджете 3D для загрузки модели.