Мобильный портал

Мобильный портал (мобильное приложение для портального пользователя) — мобильное рабочее место. Назначение мобильного портала — предоставление пользователям мобильного портала возможности создания обращений и ведения переписки со службой технической поддержки клиента.

Для мобильного портала можно настроить:

• Рабочее место пользователя мобильного портала.
• Реестр обращений.
• Страницу обращения.
• Страницу добавления обращения.

Добавить схему базового пакета в пользовательский пакет 

Если вы еще не выполняли настройки через мастер мобильного приложения, то схема базового пакета может отсутствовать в пользовательском пакете.

Чтобы добавить схему базового пакета в пользовательский пакет:

1. Перейдите в дизайнер системы по кнопке .
2. В блоке Настройка системы (System setup) перейдите по ссылке Мастер мобильного приложения (Mobile application wizard).
3. В реестре раздела откройте рабочее место Portal.
4. На панели инструментов нажмите Настроить разделы (Set up sections).
5. В реестре раздела выберите раздел Обращения (Cases) и нажмите на кнопку Настроить страницу (Page setup).
6. Сохраните настройки страницы раздела Обращения (Cases).
7. Сохраните настройки раздела Мастер мобильного приложения (Mobile application wizard).

Настроить рабочее место пользователя мобильного портала 

Действия по настройке рабочего места пользователя мобильного портала:

• Добавить рабочее место.
• Скрыть рабочее место.
• Удалить рабочее место.

Добавить рабочее место пользователя мобильного портала 

Чтобы проверить наличие рабочего места Portal:

1. Перейдите в дизайнер системы по кнопке .
2. В блоке Настройка системы (System setup) перейдите по ссылке Мастер мобильного приложения (Mobile application wizard).

Рабочее место Portal содержится в реестре раздела Мастер мобильного приложения (Mobile application wizard). По умолчанию доступно всем пользователям мобильного портала.

Если рабочее место Portal отсутствует в реестре раздела Мастер мобильного приложения (Mobile application wizard), то необходимо его добавить.

Чтобы добавить рабочее место пользователя мобильного портала:

1. Убедитесь, что используемое приложение Creatio поддерживает функциональность мобильного портала.
2. Перейдите в дизайнер системы по кнопке .
3. В блоке Настройка системы (System setup) перейдите по ссылке Мастер мобильного приложения (Mobile application wizard).
4. На панели инструментов раздела Мастер мобильного приложения (Mobile application wizard) нажмите на кнопку Добавить рабочее место (New workplace).

5. Заполните свойства рабочего места.

   • Название (Name) — название рабочего места.
   • Код (Code) — "Portal".
6. На детали Роли (Roles) настройте права доступа к рабочему месту для пользователей или групп пользователей. Подробнее читайте в статье Настроить доступ по операциям.
7. На панели инструментов нажмите Настроить разделы (Set up sections). По умолчанию в рабочее место пользователя мобильного портала добавлен раздел Обращения (Cases).
8. Сохраните настройки раздела Мастер мобильного приложения (Mobile application wizard).

В результате в приложение добавлено рабочее место пользователя мобильного портала.

Добавление рабочего места мобильного приложения подробно описано в статье Настроить рабочие места мобильного приложения.

Скрыть рабочее место пользователя мобильного портала 

1. Перейдите в дизайнер системы по кнопке .
2. В блоке Настройка системы (System setup) перейдите по ссылке Мастер мобильного приложения (Mobile application wizard).
3. В реестре раздела откройте рабочее место Portal.
4. Выполните удаление пользователей или групп пользователей рабочего места Portal. Для этого на детали Роли (Roles) нажмите и выберите пункт Удалить (Delete).

В результате в приложении скрыто рабочее место пользователя мобильного портала.

Удалить рабочее место пользователя мобильного портала 

1. Перейдите в дизайнер системы по кнопке .
2. В блоке Настройка системы (System setup) перейдите по ссылке Мастер мобильного приложения (Mobile application wizard).
3. В реестре раздела выберите рабочее место Portal и нажмите на кнопку Удалить (Delete).

В результате в приложении удалено рабочее место пользователя мобильного портала.

Настроить реестр обращений 

Действия по настройке реестра обращений для мобильного портала:

• Добавить колонку в реестр обращений.
• Добавить колонку в реестр обращений для выполнения поиска.
• Cкрыть заголовок колонки в реестре обращений.
• Изменить порядок сортировки обращений в реестре.

Добавить колонку в реестр обращений 

1. Перейдите в дизайнер системы по кнопке .
2. В блоке Настройка системы (System setup) перейдите по ссылке Мастер мобильного приложения (Mobile application wizard).
3. В реестре раздела откройте рабочее место Portal.
4. На панели инструментов нажмите Настроить разделы (Set up sections).
5. В реестре раздела выберите раздел Обращения (Cases) и нажмите на кнопку Настроить реестр (List setup).
6. В блоке Подзаголовок (Subtitle) или Дополнительные колонки (Additional columns) нажмите на кнопку Добавить колонку (New column) и выберите необходимую колонку.
7. Сохраните настройки реестра раздела Обращения (Cases).
8. Сохраните настройки раздела Мастер мобильного приложения (Mobile application wizard).

В результате колонка добавлена в реестр обращений, но добавленная колонка не учитывается при выполнении поиска. Чтобы учитывать добавленную в реестр колонку при выполнении поиска, воспользуйтесь инструкцией, которая приведена в пункте Добавить колонку в реестр обращений для выполнения поиска.

Добавление колонки в реестр раздела подробно описано в статье Настроить реестр мобильного приложения.

Добавить колонку в реестр обращений для выполнения поиска 

Поиск в реестре обращений выполняется по колонкам Номер (Number) и Описание (Description). Creatio позволяет выполнять поиск в реестре по другим колонкам обращения. Для этого их необходимо добавить в схему MobileCaseGridPageSettingsPortal.

Чтобы добавить колонку в реестр обращений для выполнения поиска:

1. Перейдите в раздел Конфигурация (Configuration).
2. В пользовательском пакете откройте схему MobileCaseGridPageSettingsPortal. Если вы еще не настраивали реестр обращений через мастер мобильного приложения, то схема MobileCaseGridPageSettingsPortal отсутствует в пользовательском пакете. Чтобы добавить схему MobileCaseGridPageSettingsPortal в пользовательский пакет, воспользуйтесь инструкцией, которая приведена в пункте Добавить схему базового пакета в пользовательский пакет.

3. Добавьте колонку в реестр обращений для выполнения поиска.

   Для Creatio версий 8.0.2 и выше

   Для Creatio версий 8.0.2 и выше добавьте операцию merge свойства diffV2. Затем в это свойство в виде строки добавьте любую операцию модификации метаданных.

   Пример добавления колонки [Subject] в реестр обращений для выполнения поиска для Creatio версий 8.0.2 и выше представлен ниже.

   Пример настройки свойства searchExpressions

   8.0.2 и выше

   [
       {
           "operation": "merge",
           "name": "settings",
           "values": {"diffV2":"[{\"operation\":\"insert\",\"name\":\"Case_Controller_SearchExpression_Subject\",\"parentName\":\"Case_Controller\",\"propertyName\":\"searchExpressions\",\"values\":{\"leftCondition\":\"Subject\"}}]"
           }
       }
       ...
   ]
   

   Здесь к текущим настройкам поиска (значение свойства searchExpressions) добавлены настройки колонки [Subject].

   Для Creatio версий 7.18.4-8.0.1

   Для Creatio версий 7.18.4-8.0.1 в свойство alias конфигурационного объекта массива модификаций diff добавьте алиас колонки, которую планируется использовать для поиска.

   Пример добавления колонки [Subject] в реестр обращений для выполнения поиска для Creatio версий 7.18.4-8.0.1 представлен ниже.

   Пример настройки свойства searchExpressions

   7.18.4-8.0.1

   [
       {
           "operation": "merge",
           "name": "settings",
           "values": {"modelViewConfig":"{\"controllers\":{\"Case\":{\"model\":{\"config\":{\"columns\":[{\"alias\":\"Case.RegisteredOn\",\"expression\":{\"columnPath\":\"RegisteredOn\",\"expressionType\":0},\"orderDirection\":2,\"orderPosition\":0}]}},\"config\":{\"searchExpressions\":[{\"alias\":\"Case.Number\",\"leftCondition\":\"Number\"},{\"alias\":\"Case.Symptoms\",\"leftCondition\":\"Symptoms\"},{\"alias\":\"Case.Subject\",\"leftCondition\":\"Subject\"}]}}}}"
           }
       }
       ...
   ]
   

   Здесь к текущим настройкам поиска (значение свойства searchExpressions) добавлены настройки колонки [Subject].

4. На панели инструментов дизайнера модуля нажмите Сохранить (Save).

В результате поиск в реестре обращений выполняется по колонкам Номер (Number), Описание (Description) и Тема (Subject).

Cкрыть заголовок колонки в реестре обращений 

1. Перейдите в раздел Конфигурация (Configuration).
2. В пользовательском пакете откройте схему MobileCaseGridPageSettingsPortal. Если вы еще не настраивали реестр обращений через мастер мобильного приложения, то схема MobileCaseGridPageSettingsPortal отсутствует в пользовательском пакете. Чтобы добавить схему MobileCaseGridPageSettingsPortal в пользовательский пакет, воспользуйтесь инструкцией, которая приведена в пункте Добавить схему базового пакета в пользовательский пакет.

3. Cкройте заголовок колонки в реестре обращений.

   Для Creatio версий 8.0.2 и выше

   Для Creatio версий 8.0.2 и выше в начало массива модификаций diffV2 добавьте конфигурационный объект колонки, заголовок которой планируется скрыть.

   1. В свойстве name укажите колонку. Шаблон имени колонки: ИмяОбъекта_ListItem_Subtitle_ИмяКолонки.
   2. В свойстве visible установите значение false. Свойство visible отвечает за отображение заголовка колонки.

   Пример скрытия заголовка колонки [Status] для Creatio версий 8.0.2 и выше представлен ниже.

   Пример настройки свойства values

   8.0.2 и выше

   [
       {
           "operation": "merge",
           "name": "settings",
           "values": {"diffV2":"[{\"operation\":\"merge\",\"name\":\"Case_ListItem_Subtitle_Status\",\"values\":{\"label\":{\"visible\":false}}}]"
           }
       }
       ...
   ]
   
   

   Case_ListItem_Subtitle_Status — значение свойства name для колонки [Status] объекта Case для приложения Creatio версии 8.0.2 и выше.

   Для Creatio версий 7.18.4-8.0.1

   Для Creatio версий 7.18.4-8.0.1 в начало массива модификаций diff добавьте конфигурационный объект колонки, заголовок которой планируется скрыть.

   1. В свойстве value укажите колонку. Шаблон имени колонки: $ИмяКолонки.
   2. В свойстве visible установите значение false. Свойство visible отвечает за отображение заголовка колонки.

   Пример скрытия заголовка колонки [Status] для Creatio версий 7.18.4-8.0.1 представлен ниже.

   Пример настройки свойства values

   7.18.4-8.0.1

   [
       {
           "operation": "merge",
           "name": "settings",
           "values": {"modelViewConfig":"{\"viewConfig\":{\"properties\":{\"body\":{\"properties\":{\"name\":\"CaseEntityList\",\"itemLayout\":{\"properties\":{\"subtitles\":[{\"alias\":\"Case.Status\",\"label\":{\"visible\":false},\"value\":\"$Status\"}]}}}}}}}"
           }
       }
       ...
   ]
   

4. На панели инструментов дизайнера модуля нажмите Сохранить (Save).

В результате заголовок колонки будет скрыт в реестре обращений.

Изменить порядок сортировки обращений в реестре 

1. Перейдите в раздел Конфигурация (Configuration).
2. В пользовательском пакете откройте схему MobileCaseGridPageSettingsPortal. Если вы еще не настраивали реестр обращений через мастер мобильного приложения, то схема MobileCaseGridPageSettingsPortal отсутствует в пользовательском пакете. Чтобы добавить схему MobileCaseGridPageSettingsPortal в пользовательский пакет, воспользуйтесь инструкцией, которая приведена в пункте Добавить схему базового пакета в пользовательский пакет.

3. Измените порядок сортировки в реестре обращений.

   Для Creatio версий 8.0.2 и выше

   Для Creatio версий 8.0.2 и выше в начало массива модификаций diffV2 добавьте конфигурационный объект с настройками отображения реестра.

   1. В свойстве name укажите колонку, которую планируется использовать для сортировки. Шаблон имени колонки: ИмяОбъекта_Model_Column_ИмяКолонки.
   2. В свойстве orderDirection укажите порядок сортировки (1 — по возрастанию, 2 — по убыванию).
   3. В свойстве orderPosition укажите порядковый индекс колонки в коллекции колонок, по которой выполняется сортировка.

   Пример изменения сортировки реестра обращений для Creatio версий 8.0.2 и выше представлен ниже. Обращения в реестре сортируются по возрастанию значений колонки [RegisteredOn].

   Пример настройки свойства values

   8.0.2 и выше

   [
       {
           "operation": "merge",
           "name": "settings",
           "values": {"diffV2":"[{\"operation\":\"merge\",\"name\":\"Case_Model_Column_RegisteredOn\",\"values\":{\"orderDirection\":1}}]"
           }
       }
       ...
   ]
   

   Case_Model_Column_RegisteredOn — значение свойства name для колонки [RegisteredOn] объекта Case для приложения Creatio версии 8.0.2 и выше.

   Для Creatio версий 7.18.4-8.0.1

   Для Creatio версий 7.18.4-8.0.1 в начало массива модификаций diff добавьте конфигурационный объект с настройками отображения реестра.

   1. В свойстве columnPath укажите имя колонки, которую планируется использовать для сортировки.
   2. В свойстве alias укажите алиас колонки, которую планируется использовать для сортировки.
   3. В свойстве orderDirection укажите порядок сортировки (1 — по возрастанию, 2 — по убыванию).
   4. В свойстве orderPosition укажите порядковый индекс колонки в коллекции колонок, по которой выполняется сортировка.

   Пример изменения сортировки реестра обращений для Creatio версий 7.18.4-8.0.1 представлен ниже. Обращения в реестре сортируются по возрастанию значений колонки [RegisteredOn].

   Пример настройки свойства values

   7.18.4-8.0.1

   [
       {
           "operation": "merge",
           "name": "settings",
           "values": {"modelViewConfig":"{\"controllers\":{\"Case\":{\"model\":{\"config\":{\"columns\":[{\"alias\":\"Case.RegisteredOn\",\"expression\":{\"columnPath\":\"RegisteredOn\",\"expressionType\": 0},\"orderDirection\":1,\"orderPosition\":0}]}}}}}"
           }
       }
       ...
   ]
   

4. На панели инструментов дизайнера модуля нажмите Сохранить (Save).

В результате в реестре отображаются обращения, которые отсортированы в указанном порядке.

Настроить страницу обращения 

Настройка страницы обращения позволяет добавить колонку на вкладку Детали (Details).

Чтобы добавить колонку на вкладку Детали (Details) страницы обращения:

1. Перейдите в дизайнер системы по кнопке .
2. В блоке Настройка системы (System setup) перейдите по ссылке Мастер мобильного приложения (Mobile application wizard).
3. В реестре раздела откройте рабочее место Portal.
4. На панели инструментов нажмите Настроить разделы (Set up sections).
5. В реестре раздела выберите раздел Обращения (Cases) и нажмите на кнопку Настроить страницу (Page setup).
6. В блоке Общая информация (General information) нажмите на кнопку Добавить колонку (New column) и выберите колонку Номер (Number).
7. Сохраните настройки страницы раздела Обращения (Cases).
8. Сохраните настройки раздела Мастер мобильного приложения (Mobile application wizard).

Настроить страницу добавления обращения 

Настройка страницы добавления обращения позволяет добавить колонку.

Чтобы добавить колонку на страницу добавления обращения:

1. Создайте схему модуля страницы обращения.

   1. Перейдите в раздел Конфигурация (Configuration).
   2. Откройте схему MobileCaseMiniPagePortal пакета CaseMobile и скопируйте ее содержимое.
   3. Выберите пользовательский пакет, в который будет добавлена схема.

   4. На панели инструментов реестра раздела нажмите Добавить —> Модуль (Add —> Module).

      

   5. Заполните свойства схемы.

      • Код (Code) — название схемы (обязательное свойство). Начинается с префикса (по умолчанию Usr), который указан в системной настройке Префикс названия объекта (Prefix for object name, код SchemaNamePrefix). Может содержать символы латинского алфавита и цифры. При создании схемы конфигурационного элемента префикс, который указан в системной настройке Префикс названия объекта (Prefix for object name, код SchemaNamePrefix), автоматически добавляется в текущее поле. Наличие префикса и его совпадение со значением системной настройки проверяется при сохранении свойств схемы. Если он отсутствует или не совпадает, то пользователь получает соответствующее уведомление.
      • Заголовок (Title) — локализуемый заголовок схемы (обязательное свойство). Заголовок схемы конфигурационного элемента генерируется автоматически и совпадает со значением свойства Код (Code) без префикса.
      
   6. В пользовательский модуль добавьте скопированное содержимое схемы MobileCaseMiniPagePortal пакета CaseMobile.
   7. В пользовательский модуль перенесите локализованные строки схемы MobileCaseMiniPagePortal пакета CaseMobile.

   8. Добавьте колонку.

      Для Creatio версий 8.0.2 и выше

      1. В свойстве value конфигурационного объекта viewConfig укажите колонку. Шаблон имени колонки: $ИмяКолонки.

         Пример добавления колонки [$ConfItem] для Creatio версий 8.0.2 и выше представлен ниже.

         Пример добавления колонки в свойство viewConfig

         8.0.2 и выше

         {
             "operation": "insert",
             "name": "CaseAddCardConfItem",
             "values": {"type": "EditField", "properties": {"value": "$ConfItem"}},
             "parentName": "CaseAddCardBody",
             "propertyName": "items",
             "index": 2
         },
         

         $ConfItem — имя колонки для приложения Creatio версии 8.0.2 и выше.

      2. В свойство controllers добавьте описание необходимой колонки. В свойстве columnPath укажите имя колонки схемы Case объекта.

         Пример добавления описания колонки [ConfItem] для Creatio версий 8.0.2 и выше представлен ниже.

         Пример добавления колонки в свойство controllers

         8.0.2 и выше

         {
             "operation": "insert",
             "name": "CaseModelConfItemColumn",
             "values": {"expression": {"columnPath": "ConfItem", "expressionType": 0}},
             "parentName": "CaseModel",
             "propertyName": "columns",
             "index": 3
         },
         

      Для Creatio версий 7.18.4-8.0.1

      1. В свойстве value конфигурационного объекта viewConfig укажите колонку. Шаблон имени колонки: $ИмяКолонки.

         Пример добавления колонки [$ConfItem] для Creatio версий 7.18.4-8.0.1 представлен ниже.

         Пример добавления колонки в свойство viewConfig

         7.18.4-8.0.1

         "viewConfig": {
             ...
             "editCard": {
                 ...
                 "body": {
                     ...
                     "items": [
                         ...
                         {
                             "type": "EditField",
                             "properties": {
                                 "value": "$ConfItem"
                             }
                         }
                     ]
                 }
             }
         }
         

         $ConfItem — имя колонки для приложения Creatio версии 7.18.4-8.0.1.

      2. В свойство controllers добавьте описание необходимой колонки. В свойстве columnPath укажите имя колонки схемы Case объекта.

         Пример добавления описания колонки [ConfItem] для Creatio версий 7.18.4-8.0.1 представлен ниже.

         Пример добавления колонки в свойство controllers

         7.18.4-8.0.1

         "controllers": {
             ...
             "model": {
                 ...
                 "columns": [
                 ...
                     {
                         "expression": {
                             "columnPath": "ConfItem",
                             "expressionType": 0
                         }
                     }
                 ]
             }
         }
         

   9. На панели инструментов дизайнера модуля нажмите Сохранить (Save).

2. В манифесте портального рабочего места зарегистрируйте ранее созданную пользовательскую схему UsrMobileCaseMiniPagePortal.

   1. В пользовательском пакете откройте схему MobileApplicationManifestPortal. Если вы еще не настраивали приложение через мастер мобильного приложения, то схема MobileApplicationManifestPortal отсутствует в пользовательском пакете. Чтобы добавить схему MobileApplicationManifestPortal в пользовательский пакет, воспользуйтесь инструкцией, которая приведена в пункте Добавить схему базового пакета в пользовательский пакет.

   2. Зарегистрируйте схему.

      1. В свойстве Modules укажите схему, которая используется для добавления записи схемы Case объекта.
      2. В свойстве Models укажите схему, которая используется для расширения схемы Case объекта.

      Пример регистрации схемы UsrMobileCaseMiniPagePortal представлен ниже.

      Пример настройки свойств Modules и Models

      {
          ...
          "Modules": {
              "Case": {
                  ...
                  "screens": {
                      ...
                      "add": {
                          "schemaName": "UsrMobileCaseMiniPagePortal"
                      }
                      ...
                  }
                  ...
              }
              ...
          },
          "Models": {
              "Case": {
                  ...
                  "PagesExtensions": [
                      "UsrMobileCaseMiniPagePortal"
                  ]
              }
              ...
          }
          ...
      }
      

3. На панели инструментов дизайнера модуля нажмите Сохранить (Save).