Внешнее приложение ELMA - это специализированное программное обеспечение или расширение для программного обеспечения, предназначенное для взаимодействия с системой ELMA. Внешнее приложение может выполняться на различном оборудовании и в различных операционных системах.
Для авторизации внешнего приложения в системе ELMA используется токен. Управление информацией о внешних приложениях и токенами внешних приложений осуществляется в разделе Администрирование - Система - Внешние приложения (рис. 1).
Рис. 1. Раздел "Администрирование - Система - Внешние приложения"
В списке отображается общая информация о зарегистрированных в системе внешних приложениях:
-
Активно - статус приложения, отображающий, разрешено ли в данный момент указанному внешнему приложению взаимодействовать с системой ELMA;
-
Название - отображаемое имя приложения;
-
Автор - наименование разработчика приложения;
-
Сайт - ссылка на сайт приложения или автора приложения;
-
Описание - информация о назначении приложения;
-
Кнопка 
позволяет удалить внешнее приложение из списка. При этом удаляются все токены приложения и его авторизация в системе ELMA становится невозможна. Эта кнопка доступна только для внешних приложений, не являющихся системными внешними приложениями системы ELMA.
Системные внешние приложения
На данный момент существуют следующие системные внешние приложения системы ELMA:
-
Elma for iPad - программа, предназначенная для работы с системой ELMA на планшетах Apple iPad.
-
ElmaAgent - программа ELMA Агент для быстрой работы с лентой сообщений и документами системы ELMA.
-
Elma KPI for iPad - приложение "Управление показателями", предназначенное для работы с показателями на планшетах Apple iPad.
Системные внешние приложения не могут быть удалены, однако для них доступны операции активации / деактивации и изменения токенов системы.
Пользовательские внешние приложения
Система ELMA поддерживает возможность использования пользовательских внешних приложений. Для взаимодействия таких внешних приложений с системой необходимо:
-
-
-
-
Использовать созданный токен для авторизации приложения на сервере ELMA при отправке запросов.
Добавление пользовательского внешнего приложения в список
Для добавления пользовательского внешнего приложения в список внешних приложений необходимо нажать кнопку Добавить (рис. 2).
Рис. 2. Раздел "Внешние приложения". Кнопка "Добавить"
На появившейся форме необходимо заполнить информацию о пользовательском расширении (рис. 3):
-
Наименование - отображаемое имя приложения;
-
Описание - информация о назначении приложения, данное поле не обязательно для заполнения;
-
Авторство приложения - наименование разработчика приложения;
-
Сайт приложения - ссылка на сайт приложения или автора приложения;
Рис. 3. Форма добавления пользовательского внешнего приложения
Для завершения процедуры добавления внешнего приложения необходимо нажать кнопку Сохранить. Нажатие кнопки Отмена приведёт к возврату к списку внешних приложений без сохранения внесённых данных.
Карточка внешнего приложения
Для перехода к карточке внешнего приложения необходимо кликнуть по его названию в списке внешних приложений.
Карточка внешнего приложения содержит две вкладки, О приложении и Токены приложения, а также кнопку включения / отключения активации приложения и кнопку возврата к предыдущей странице в верхней панели инструментов (рис. 4).
Карточка внешнего приложения. Вкладка "О приложении"
На вкладке О приложении отображается общая информация о внешнем приложении (рис. 4):
-
Сайт приложения - ссылка на сайт приложения или автора приложения;
-
Наименование - отображаемое имя приложения;
-
Описание - информация о назначении приложения;
-
Авторство приложения - наименование разработчика приложения;
-
Активно - статус приложения, отображающий, разрешено ли в данный момент указанному внешнему приложению взаимодействовать с системой ELMA.
Рис. 4. Карточка внешнего приложения с отключенной активацией
Карточка внешнего приложения. Включение и отключение активации приложения
На рис. 4 приведен пример внешнего приложения с отключенной активацией. Для такого приложения нельзя создать токен. Если токен уже создан, система ELMA будет отклонять попытки авторизации с его использованием. Для включения активации необходимо нажать кнопку Включить.
Внешнее приложение со включенной активацией может авторизоваться в системе с использованием токена приложения. Если необходимо запретить приложению подключаться к серверу ELMA, требуется отключить активацию. Для отключения активации необходимо нажать кнопку Отключить (рис. 5).
Рис. 5. Карточка внешнего приложения со включенной активацией
Карточка внешнего приложения. Вкладка "Токены приложения"
Токен приложения - уникальный ключ, используемый для авторизации приложения в системе ELMA. Токен представлен в виде 128-символьной строки, состоящей из шестнадцатеричных символов.
На вкладке Токены приложения отображается общая информация о токенах (рис. 6):
-
Токен - первые 30 символов токена приложения. Клик по токену приводит к отображению всех 128 символов токена;
-
Истекает - дата, до которой указанный токен может использоваться при авторизации приложения. Клик по дате позволяет обновить дату истечения токена.
-
Кнопка позволяет удалить токен из списка. Авторизация в системе ELMA с использованием этого токена становится невозможна. Удалить токен системного внешнего приложения невозможно.
Рис. 6. Карточка внешнего приложения, когда оно активировано
Кнопка Добавить токен позволяет создать новый токен приложения. Для создания токена достаточно указать дату истечения нового токена (рис. 7).
Рис. 7. Карточка внешнего приложения, когда оно активировано
См. также:
