как деинсталлировать установленные приложения маркетплейс в creatio
Мобильное приложение
Мобильное приложение является инструментом для работы с данными приложения Creatio на мобильных устройствах. Мобильное приложение Creatio — это удаленное рабочее место, которое предоставляет быстрый доступ к данным клиентов, рабочему календарю, мобильной рассылке и т. д.
Мобильное приложение Creatio доступно для загрузки в App Store и Google Play на мобильные устройства, которые соответствуют требованиям.
Общие принципы работы
Преимущества использования мобильного приложения Creatio:
Мобильное приложение Creatio использует гибридный подход технической реализации. Гибридное приложение — это мобильное приложение, «упакованное» в native-оболочку. В отличие от мобильного native-приложения, является легко переносимым между различными платформами.
Перед началом работы с мобильным приложением необходимо в основном приложении выполнить первичную настройку.
Синхронизация мобильного приложения с сервером Creatio выполняется с помощью сервиса работы с данными DataService. Если при синхронизации возникли конфликты, то информация о них отобразится в журнале синхронизации, который доступен в гибридном и offline режимах.
Для проверки корректности работы пользовательской функциональности, необходимо выполнить отладку мобильного приложения.
Схема работы
Мобильное приложение Creatio представляет собой набор модулей, необходимых для синхронизации с сервером Creatio. Схема работы мобильного приложения представлена ниже.
Каждый продукт и отдельно взятый сайт клиента может содержать следующие пользовательские элементы:
Пользователю мобильного приложения Creatio необходимо установить его и выполнить синхронизацию с основным приложением.
Схема архитектуры
Схема архитектуры мобильного приложения Creatio представлена ниже.
Для создания гибридных приложений мобильное приложение Creatio использует фреймворк Apache Cordova, который предоставляет следующие возможности:
Ядро мобильного приложения Creatio предоставляет унифицированный интерфейс для взаимодействия клиентских частей приложения. Используемые ядром JavaScript-файлы условно можно разделить на базовые и конфигурационные.
Базовые скрипты содержатся в сборке приложения, публикуемой в магазине приложений. Компоненты базовых скриптов:
Конфигурационные файлы, полученные при синхронизации с сервером Creatio, приложение получает и локально сохраняет в файловой системе устройства. Компоненты конфигурационных файлов:
Манифест — это конфигурационный объект, свойства которого описывают структуру (объекты и связи между ними) мобильного приложения. Группы свойств манифеста мобильного приложения Creatio:
В разделе Визы ( Approvals ) мобильного приложения используется Flutter Framework.
Совместимость с продуктами Creatio
Мобильное приложение является частью платформы и доступно для пользователей основного приложения Creatio версий 7.15 и выше.
После установки приложения на мобильное устройство пользователь, указав параметры соединения с сервером Creatio, получает метаданные (структура приложения, системные данные) и данные от сервера. Эта схема работы позволяет мобильному приложению быть совместимым со всеми продуктами Creatio.
На заметку. Мобильное приложение не может использоваться пользователями портала.
Установить приложение Marketplace
Раздел Установка и удаление приложений предназначен для управления приложениями и расширениями в Creatio.
Функциональность раздела позволяет:
Установить приложение из Marketplace
Установить приложение из файла
Вы также можете установить приложение из файла формата *.zip или *.gz. Этот способ может быть более удобным для пользователей Creatio on-site с ограниченным доступом внешних запросов. Для этого:
Установить приложение на среду с балансировщиком
Если для обеспечения отказоустойчивости в вашем приложении используется балансировщик нагрузки, то процесс установки приложения Marketplace будет отличаться от обычного.
На заметку. Аналогичным образом выполняется установка на промышленную среду пакетов с изменениями, которые были созданы и протестированы на других средах.
Рекомендуется выполнять настройку не в бизнес-время, так как при этом приложение Creatio будет недоступно. Ниже приведен общий порядок действий, которые необходимо выполнить для установки пакета. Детали могут различаться в зависимости от используемого в вашем приложении балансировщика.
Общий порядок установки
Перейдите к работающему экземпляру приложения и установите приложение Marketplace. Подробнее: Установить приложение из файла.
По завершении установки приложения автоматически будет выполнена компиляция.
После успешной компиляции переходите к следующему шагу. Если возникла ошибка, то скачайте логи приложения и посмотрите ее детальное описание.
Если ошибка возникла на стороне Creatio, то выполните возврат к предыдущему состоянию конфигурации (Рис. 2) и повторите установку.
Очистите Redis.
Запустите все остановленные экземпляры Creatio. Подробнее: Запуск, компиляция и проверка работы сайта (инструкция по обновлению).
Отключите переадресацию на стороне балансировщика.
Управление приложениями
После установки вы можете приобрести лицензии, чтобы продолжить работу с приложением после завершения ознакомительного периода или же удалить его.
Чтобы удалить установленное приложение, нажмите кнопку Удалить и дождитесь завершения процесса.
Установить приложение Marketplace
Раздел Установка и удаление приложений предназначен для управления приложениями и расширениями в Creatio.
Функциональность раздела позволяет:
Установить приложение из Marketplace
Установить приложение из файла
Вы также можете установить приложение из файла формата *.zip или *.gz. Этот способ может быть более удобным для пользователей Creatio on-site с ограниченным доступом внешних запросов. Для этого:
Установить приложение на среду с балансировщиком
Если для обеспечения отказоустойчивости в вашем приложении используется балансировщик нагрузки, то процесс установки приложения Marketplace будет отличаться от обычного.
На заметку. Аналогичным образом выполняется установка на промышленную среду пакетов с изменениями, которые были созданы и протестированы на других средах.
Рекомендуется выполнять настройку не в бизнес-время, так как при этом приложение Creatio будет недоступно. Ниже приведен общий порядок действий, которые необходимо выполнить для установки пакета. Детали могут различаться в зависимости от используемого в вашем приложении балансировщика.
Общий порядок установки
Перейдите к работающему экземпляру приложения и установите приложение Marketplace. Подробнее: Установить приложение из файла.
По завершении установки приложения автоматически будет выполнена компиляция.
После успешной компиляции переходите к следующему шагу. Если возникла ошибка, то скачайте логи приложения и посмотрите ее детальное описание.
Если ошибка возникла на стороне Creatio, то выполните возврат к предыдущему состоянию конфигурации (Рис. 2) и повторите установку.
Очистите Redis.
Запустите все остановленные экземпляры Creatio. Подробнее: Запуск, компиляция и проверка работы сайта (инструкция по обновлению).
Отключите переадресацию на стороне балансировщика.
Управление приложениями
После установки вы можете приобрести лицензии, чтобы продолжить работу с приложением после завершения ознакомительного периода или же удалить его.
Чтобы удалить установленное приложение, нажмите кнопку Удалить и дождитесь завершения процесса.
Лицензировать Creatio
Доступ к функциональности Creatio получают только лицензированные пользователи.
Этапы лицензирования в Creatio:
Эти операции выполняются в разделе Менеджер лицензий (Рис. 1).
Если истек срок действия лицензий, то при попытке входа в систему пользователя, который включен в организационную роль “Системные администраторы”, менеджер лицензий откроется автоматически.
На заметку. Чтобы просматривать, раздавать и отзывать лицензии, у вас должны быть настроены права доступа на выполнение системной операции “Управление лицензиями пользователей” (код “CanManageLicUsers”). Подробнее: Настроить права доступа на системные операции.
Добавить лицензии в приложение
Процедура лицензирования программного обеспечения одинакова для всех типов лицензий, использующихся в Creatio.
При покупке лицензий, продлении действия существующих лицензий и обновлении on-site приложения Creatio:
Начиная с версии 7.17.4 данную процедуру необходимо выполнять также и при обновлении on-site приложения Creatio на новую версию.
Сформировать запрос на получение лицензий
Нажмите кнопку Сформировать запрос (Рис. 2).
В результате будет создан и загружен файл запроса лицензий в формате *.tlr.
Запросить лицензии также можно в разделе Пользователи системы по действию Запросить лицензии (Рис. 3).
Загрузить лицензии в приложение
Нажмите Действия —> Загрузить (Рис. 4).
Запросить лицензии также можно в разделе Пользователи системы по действию Загрузить лицензии (Рис. 5).
В результате новые лицензии будут загружены в систему. При этом может увеличиться общее количество лицензий, а также будут продлены сроки действия лицензий.
Распределить лицензии между пользователями
Чтобы пользователь мог войти в систему, необходимо выполнить лицензирование его учетной записи. Администратор системы может в любое время перераспределить существующие лицензии. Количество активных и доступных лицензий отображается на странице лицензирования продукта и зависит от типа лицензии (Рис. 6 и 7).
В Creatio используются следующие типы лицензий:
Кликните по названию продукта.
Откроется страница лицензирования продукта. Здесь вы можете увидеть тип лицензии, дату ее начала и завершения, статус, количество доступных лицензий, а также распределить существующие лицензии между пользователями.
Нажмите кнопку Добавить и выберите пользователей, которым вы хотите выдать лицензии (Рис. 8).
Обратите внимание, что число указанных пользователей не должно быть больше количества лицензий. Количество доступных/использованных лицензий можно отслеживать на круговой диаграмме в левой части экрана (Рис. 8).
При необходимости вы можете отозвать лицензии, чтобы затем перераспределить их другим пользователям.
Чтобы отозвать лицензии, выберите пользователей из списка и нажмите кнопку Отозвать лицензии (Рис. 9).
Вы также можете навести курсор на строку с именем пользователя, у которого вы хотите отозвать лицензию, и нажать кнопку (Рис. 10).
В результате для выбранных учетных записей будут предоставлены либо отозваны лицензии Creatio.
Удалить лицензии в приложении
Есть случаи, когда необходимо удалить лицензии (например, при переводе приложения в демо-режим).
Чтобы удалить лицензии в приложении:
Защита исходного кода приложения Marketplace от плагиата
Открытый исходный код приложения Marketplace содержится в пакете, который заблокирован для изменения. При этом код доступен к просмотру пользователям с соответствующим уровнем доступа и не защищен от плагиата. Реализация защиты от плагиата выполняется отдельно для back-end и для front-end кода.
Защита C#-кода от плагиата
Использование пакета-проекта позволяет защитить C#-код приложения Marketplace от плагиата.
Важно. Настройку защиты исходного кода приложения Marketplace от плагиата разрешено выполнять только для исходного C#-кода собственной разработки.
Способы защиты C#-кода приложения Marketplace от плагиата:
Разработка приложения Marketplace, как и других приложений, выполняется на уровне конфигурации, который содержит предустановленные пакеты приложения. В процессе публикации исходный C#-код пакетов компилируется в библиотеку Terrasoft.Configuration.dll и может взаимодействовать с ядром. Описание уровней кастомизации приложения Creatio содержится в статье Разработка приложений на платформе Creatio. Детализированная схема уровней кастомизации приложения Creatio представлена на рисунке ниже.
Возможности, которые предоставляет использование пакета-проекта с приложением Marketplace:
Схема уровней кастомизации приложения Creatio при наличии пакета-проекта, который содержит приложение Marketplace, представлена на рисунке ниже.
Разработать приложение Marketplace в пакете-проекте
Разработку нового приложения Marketplace рекомендуется выполнять в пакете-проекте.
Чтобы разработать приложение Marketplace в пакете-проекте:
1. Настроить Creatio для работы в файловой системе
Для настройки Creatio для работы в файловой системе воспользуйтесь инструкцией, которая приведена в статье Внешние IDE.
2. Создать пользовательский пакет
Инструменты, который позволяют создать пользовательский пакет:
Чтобы создать пользовательский пакет с использованием утилиты clio:
Выполните установку clio (при необходимости).
Установка clio подробно описана в официальной документации утилиты на GitHub.
Перейдите в каталог Pkg приложения.
Создайте новый пакет.
Ниже приведен пример установки зависимостей (свойство DependsOn ) пакета OurPackage от пакета ProductCore и добавления описания (свойство Descriptor ) пакета.
3. Разработать пользовательскую функциональность
Для разработки пользовательской функциональности можно использовать любую внешнюю IDE. В нашем примере разработка выполняется в Microsoft Visual Studio Code.
Чтобы разработать пользовательскую функциональность:
Реализуйте пользовательскую функциональность в каталоге Files\cs приложения.
Выполните сборку приложения.
Если сборка приложения выполнится успешно, то *.dll, *.pdb и другие вспомогательные файлы помещаются в каталог Files\Bin приложения.
Загрузите пакет OurPackage из каталога [Путь к приложению]\Terrasoft.WebApp\Terrasoft.Configuration\Pkg в базу данных.
В группе Разработка в файловой системе ( File system development mode ) выпадающего списка Действия ( Actions ) панели инструментов нажмите Обновить пакеты из файловой системы ( Update packages from file system ).
В результате пакет OurPackage загружен в Creatio IDE.
4. Выполните сборку пакета-проекта
Назначение выполнения сборки пакета-проекта — подготовка приложения Marketplace к публикации на онлайн-площадке Creatio Marketplace.
Важно. Если вы не хотите, чтобы исходный C#-код собственной разработки был включен в пакет-проект, то обязательно удалите его перед выполнением экспорта пакета.
Чтобы выполнить сборку пакета-проекта:
В файл PackagePublish.target добавьте код.
В файл OurPackage.csproj добавьте строку.
Откройте командную строку и выполните команду.
Конвертировать пакет с приложением Marketplace в пакет-проект
Подготовка ранее разработанного приложения Marketplace к конвертации в пакет-проект может потребовать значительных модификаций.
Чтобы конвертировать разработанное приложение Marketplace в пакет-проект, выполните одну из команд:
Содержимое C#-проекта после выполнения конвертации:
Структура C#-проекта после выполнения конвертации представлена на рисунке ниже.
В результате разработанное приложение Marketplace конвертировано в пакет-проект, который можно устанавливать в приложение Creatio.
На заметку. Формирование пакета-проекта является обязательным звеном CI/CD-конвейера. В репозитории рекомендуется хранить незащищенный от плагиата исходный C#-код приложения Marketplace.
Защита JavaScript-кода от плагиата
Способы защиты JavaScript-кода приложения Marketplace от плагиата:
Важно. Запрещено изменять структуру схемы клиентского модуля, поскольку дизайнеры приложения настроены на работу с определенной структурой схемы.
Лучшей практикой защиты JavaScript-кода от плагиата является использование миксинов для реализации логики, которую необходимо защитить. Не рекомендуется обфусцировать схемы клиентских модулей, которые используются мастерами (разделов, страниц, деталей) приложения.
Существует большое количество решений с открытым исходным кодом для обфускации JavaScript-кода. В нашем примере мы используем обфускатор JavaScript Obfuscator. Официальная документация обфускатора доступна на GitHub.
Чтобы защитить JavaScript-код от плагиата с использованием JavaScript Obfuscator:
Выполните установку JavaScript Obfuscator.
Установка JavaScript Obfuscator подробно описана в официальной документации обфускатора на GitHub.
Подготовьте JavaScript-код к обфускации.
В миксине реализуйте JavaScript-код, который планируется обфусцировать.
Укажите миксин MRKT_DemoMixin в свойстве mixins клиентской схемы (например, ContactPageV2 ).
Выполните обфускацию JavaScript-кода.
Выполнение обфускации в JavaScript Obfuscator подробно описана в официальной документации обфускатора на GitHub.
В результате получим обфусцированный файл. Пример обфусцированного файла приведен ниже.
Чтобы посмотреть отображение JavaScript-кода на странице браузера:
Пример отображения JavaScript-кода на странице браузера приведен на рисунке ниже.
На заметку. Обфусцирование JavaScript-кода является обязательным звеном CI/CD-конвейера. В репозитории рекомендуется хранить незащищенный от плагиата исходный JavaScript-код приложения Marketplace.