Команда startView#
Открытие окна приложения#
Команда startView используется для открытия конкретного окна приложения КриптоАРМ.
Схема взаимодействия:

Формат ссылки#
Для выполнения команды startView должна быть сформирована ссылка вида:
-
cryptoarm://- зарегистрированный протокол -
startView- выполняемая команда -
<URL>- ссылка на получение JSON с параметрами, нужными для выполнения команды -
id- уникальный идентификатор транзакции
Пример:
Общее#
Все запросы между КриптоАРМ и сервером ДОЛЖНЫ соответствовать спецификации протокола JSON-RPC 2.0.
В качестве транспорта используется HTTP.
Общее описание указано в разделе Формат ссылки.
Получение параметров операции#
После получения команды startView КриптоАРМ отправляет запрос на получение параметров операции.
Формат запроса#
| Ключ | Значение | Описание |
|---|---|---|
| jsonrpc | «2.0» | Версия JSON-RPC протокола. Всегда «2.0». |
| method | startView.parameters | Используемый метод. Всегда startView.parameters. |
| id | Уникальный идентификатор | Используется идентификатор, который указан в ссылке на операцию. Подробнее в разделе Формат ссылки |
| diagnostic | IDiagnosticInformaton | Диагностическая информация о рабочем месте |
Пример:
Формат ответа#
| Ключ | Значение | Описание |
|---|---|---|
| jsonrpc | «2.0» | Версия JSON-RPC протокола. Всегда «2.0». |
| result | IStartViewParameters | Объект со сведениями о параметрах операции |
| id | Уникальный идентификатор | Используется идентификатор, который указан в ссылке на операцию. Подробнее в разделе Формат ссылки |
Пример:
Интерфейс IStartViewParameters#
Объекты данного типа описывают вид операции и её параметры.
| Ключ | Значение | Описание |
|---|---|---|
| uiView | string | Тип окна, которое нужно отобразить пользователю. Доступные значения: “MAIL” – окно почты, “DOCUMENTS” – окно Документы, “SIGN_AND_ENCRYPT” - окно подписи и шифрования, “CERTIFICATES_MY” - окно Сертификаты/Личные сертификаты, “CERTIFICATES_ADDRESS_BOOK” - окно Сертификаты/Другие пользователи, “CERTIFICATES_CA” - окно Сертификаты/Промежуточные, “CERTIFICATES_ROOT” - окно Сертификаты/Корневые, “CONTACTS” - окно Контакты, “KEYS” - окно Сертификаты/Список контейнеров, “ABOUT” и “DIAGNOSTIC” - окно О программе (Настройки). |
| props | IStartViewOperationProps | Параметры операции |
Интерфейс IStartViewOperationProps#
Интерфейс IStartViewOperationProps описывает параметры операции.
| Свойство | Тип | Описание |
|---|---|---|
| headerText? | string | Необязательный параметр. Используется для отображения в заголовке окна. Максимальная длина - 40 символов. |
| descriptionText? | string | Необязательный параметр. Используется для отображения в сведениях об операции. Максимальная длина - 120 символов. |