Добавить метаданные для опубликованного Marketplace-приложения

Средний

Хранение метаданных Marketplace-приложения доступно в Creatio версии 8.0.2 и выше.

В данном случае, метаданные — это сведения о приложении, которые хранятся в самом приложении вне зависимости от среды.

Параметры, которые хранятся в метаданных Marketplace-приложения:

  • Иконка (поле Выберите иконку (Select icon)).
  • Цвет иконки (поле Цвет (Color)).
  • Название (поле Назовите приложение (Give it a name)).
  • Описание (поле Опишите назначение приложения (необязательно) (Describe what it’s for (optional))).
  • Код (поле Код приложения (Application code)).

Значения параметров, которые хранятся в метаданных Marketplace-приложения, настраиваются в центре приложений. О центре приложений читайте в статье Создать пользовательское приложение.

Поскольку создание Marketplace-приложения не отличается от создания приложения Creatio, для настройки или изменения метаданных воспользуйтесь инструкцией, которая приведена в статье Настроить метаданные приложения. Заполнить значения параметров вы можете только при создании приложения, а изменить их в любой момент. Код генерируется при создании приложения и в дальнейшем недоступен для изменения.

На заметку. Добавьте метаданные для Marketplace-приложений, которые были разработаны для версии 8.0.1 и ниже (т. е. не содержат метаданных).

Чтобы добавить метаданные Marketplace-приложения:

  1. Установите Marketplace-приложение в приложение версии 8.0.2 и выше. Для этого воспользуйтесь инструкцией, которая приведена в статье Установить приложение Marketplace.
  2. Используя утилиту Clio, разблокируйте пакет с функциональностью Marketplace-приложения. Для этого воспользуйтесь инструкцией, которая приведена в документации утилиты на GitHub.
  3. Разблокируйте Marketplace-приложение в центре приложений. Для этого в базе данных выполните SQL-скрипт, который приведен ниже.

    Шаблон SQL-скрипта
    MS SQL
    Oracle
    PostgreSQL
    UPDATE SysInstalledApp
    SET Maintainer = (SELECT TextValue FROM SysSettings
        JOIN SysSettingsValue ON SysSettingsValue.SysSettingsId = SysSettings.Id
        WHERE Code = 'Maintainer'
        AND SysSettingsValue.SysAdminUnitId = 'A29A3BA5-4B0D-DE11-9A51-005056C00008')
    WHERE name='SomeMarketplaceApplicationName'
    
    UPDATE "SysInstalledApp"
    SET "Maintainer" = (SELECT "TextValue" FROM "SysSettings"
        JOIN "SysSettingsValue" ON "SysSettingsValue"."SysSettingsId" = "SysSettings"."Id"
        WHERE "Code" = 'Maintainer'
        AND "SysSettingsValue"."SysAdminUnitId" = '{A29A3BA5-4B0D-DE11-9A51-005056C00008}') 
    WHERE "Name" = 'SomeMarketplaceApplicationName'
    
    UPDATE "SysInstalledApp"
    SET "Maintainer" = (SELECT "TextValue" FROM "SysSettings"
        JOIN "SysSettingsValue" ON "SysSettingsValue"."SysSettingsId" = "SysSettings"."Id"
        WHERE "Code" = 'Maintainer'
        AND "SysSettingsValue"."SysAdminUnitId" = 'A29A3BA5-4B0D-DE11-9A51-005056C00008')
    WHERE "Name" = 'SomeMarketplaceApplicationName'
    

    SomeMarketplaceApplicationName — имя установленного пакета с функциональностью Marketplace-приложения.

  4. Добавьте метаданные Marketplace-приложения. Для этого воспользуйтесь инструкцией, которая приведена в статье Настроить метаданные приложения.
  5. Заблокируйте пакет с функциональностью Marketplace-приложения. Для этого выполните SQL-скрипт, который приведен ниже.

    Шаблон SQL-скрипта
    MS SQL
    Oracle
    PostgreSQL
    UPDATE SysInstalledApp
    SET Maintainer='SomeMarketplaceApplicationMaintainer'
    WHERE Name='SomeMarketplaceApplicationName'
    
    UPDATE "SysInstalledApp" 
    SET "Maintainer" = 'SomeMarketplaceApplicationMaintainer'
    WHERE "Name" = 'SomeMarketplaceApplicationName'
    
    UPDATE "SysInstalledApp" 
    SET "Maintainer" = 'SomeMarketplaceApplicationMaintainer'
    WHERE "Name" = 'SomeMarketplaceApplicationName'
    

    SomeMarketplaceApplicationMaintainer — издатель пакета с функциональностью Marketplace-приложения.

    SomeMarketplaceApplicationName — имя установленного пакета с функциональностью Marketplace-приложения.

  6. Экспортируйте пакет с функциональностью Marketplace-приложения. Для этого воспользуйтесь инструкцией, которая приведена в статье Центр приложений.
  7. Загрузите *.zip-архив с Marketplace-приложением в личный кабинет разработчика.
  8. Отправьте Marketplace-приложение на верификацию.

После успешной верификации Marketplace-приложения службой поддержки Marketplace-приложение автоматически публикуется на Creatio Marketplace. После установки Marketplace-приложения значения заданных параметров будут отображаться в приложении Creatio, на которое установлено Marketplace-приложение.