Публичные и внутренние формы. Контроль доступа

Введение

Для любого шаблона (кроме шаблона процесса) можно создать неограниченное число форм. На них можно поместить разные атрибуты, и каждая форма может предназначаться для отдельной категории пользователей.

Доступ пользователей к форме определяется с помощью ролей и типа формы.

Здесь представлены инструкции по контролю доступа к формам посредством типа формы, а также по созданию ссылок на формы для внешних пользователей.

Пример настройки внутренней формы для ограничения доступа к ней

В качестве примера создадим в шаблоне записи две формы и разграничим доступ к ним:

• Клиент — публичная форма, будет доступна через селектор форм ‌ наряду с основной формой шаблона.
• Диспетчер — внутренняя форма, не будет доступна через селектор форм. Пользователь сможет перейти к этой форме только по прямой ссылке, например, отправленной в эл. письме.

Настройка форм

1. Создайте приложение «Оформление заявок».

2. Создайте шаблон записи «Заявки» со следующими атрибутами:

   Название	Тип	Свойства
   Тип ТС	Список значений	Добавьте значения «легковой автомобиль», «автобус», «грузовой автомобиль»
   Количество пассажиров	Число	Количество знаков после запятой: 0
   Водитель	Аккаунт

3. Поместите на основную форму шаблона атрибуты «Тип ТС» и «Количество пассажиров».

4. Создайте форму «Клиент» и поместите на неё атрибут «Количество пассажиров».
5. Создайте форму «Диспетчер» и поместите на неё атрибуты «Тип ТС», «Количество пассажиров», «Водитель».
6. В свойствах формы «Диспетчер» выберите тип «Внутренняя».

Тестирование внешней формы

1. Создайте новую запись в шаблоне «Заявки».
2. Откроется основная форма шаблона.

3. Нажмите селектор форм ‌ рядом с заголовком записи:

   • В раскрывающемся списке под селектором будут отображаться основная форма шаблона и форма «Клиент».
   • Форма «Диспетчер» в списке отображаться не будет.

4. Выберите и просмотрите форму «Клиент».

5. Перейдите к форме «Диспетчер», используя ссылку вида:

   http://<hostname>/#form/<oa.XX>/<form.XX>/<RecordID> 
   

   Здесь:

   • http://<hostname>/ — адрес сервера Comindware Platform;
   • <oa.XX> — ID шаблона записи «Заявки» (его видно в списке шаблонов);
   • <form.XX> — ID формы «Диспетчер» (его видно в адресной строке браузера в конструкторе формы);
   • <RecordID> — ID записи «Заявки».

Пример создания ссылки на внешнюю форму

Рассмотрим пример настройки ссылки на внешнюю форму «Клиент» из предыдущего примера, чтобы любой клиент мог оставлять заявку, не выполняя вход в Comindware Platform.

Настройка ссылки

1. Соберите следующие данные для формирования ссылки:

   • ID приложения «Оформление заявок», например sol.1;
   • ID шаблона «Заявки», например oa.1;
   • ID формы «Клиент», например form.1;
   • Значение атрибута «Количество пассажиров» для заполнения формы, например 2.

2. Выполните POST‑запрос к методу Base/EncryptedNavigationReferenceService/Generate:

   curl -X POST \ 
   "https://<your-host>/api/public/system/Base/EncryptedNavigationReferenceService/Generate" \ 
   -H "Content-Type: application/json" \ 
   -u <username>:<password> \ 
   -d '{ 
       "SolutionId": "sol.1", 
       "ObjectId": "oa.1", 
       "TargetId": "form.1", 
       "TargetType": "Form" 
       }' 
   

   Здесь: "TargetType": "Form" — обязательный фиксированный параметр, который не следует изменять.

   Подставьте фактические ID

   Не забудьте указать в запросе фактические идентификаторы сущностей из своего экземпляра Comindware Platform.

3. В ответ придёт сгенерированная ссылка на форму вида:

   "https://<your-host>/Resolve?data=<encryptedData>" 
   

4. Проверьте, что ссылка сформирована корректно, с помощью метода Base/EncryptedNavigationReferenceService/Decrypt, указав в теле запроса закодированную строку <encryptedData> (без части https://<your-host>/Resolve?data=):

   curl -X POST \ 
   "https://<your-host>/api/public/system/Base/EncryptedNavigationReferenceService/Decrypt" \ 
   -H "Content-Type: application/json" \ 
   -u <username>:<password> \ 
   -d "<encrypted>" 
   

5. В ответ должен прийти объект со свойствами целевой формы:

   { 
       "SolutionId": "sol.1", 
       "ObjectId": "oa.1", 
       "TargetId": "form.1", 
       "TargetType": "Form" 
   } 
   

Тестирование внешней формы

1. Откройте браузер на мобильном устройстве в режиме «Инкогнито», чтобы протестировать форму от лица внешнего пользователя.

2. Вставьте в адресную строку ссылку на внешнюю форму вида:

   https://<your-host>/Resolve?data=<encryptedData> 
   

3. Должна открыться форма «Клиент».

4. Заполните и сохраните форму.
5. Откройте браузер на компьютере.
6. Войдите в Comindware Platform.
7. Удостоверьтесь, что в шаблоне «Заявки» появилась запись, заполненная с помощью внешней формы на мобильном устройстве.