Пример: Миграция процесса обслуживания в объединенный каталог

Упростите управление запросами на прием, преобразовав определения процессов обслуживания в Service Process Studio в стандартные записи продуктов. Управляйте всеми предложениями продуктов и услуг вместе в одном месте.

Требуемые версии

Доступно в версиях: Lightning Experience

Доступно в версиях: Версии Enterprise Edition, Unlimited Edition и Developer Edition с Financial Services Cloud и Unified Catalog.

Прежде чем начать, убедитесь в наличии активного процесса оплаты «Остановить проверку», изначально созданного в Service Process Studio.

Данная задача использует процесс службы «Остановить проверку оплаты» в качестве примера для демонстрации этапов миграции. В этом сценарии исходное определение процесса обслуживания содержит три атрибута, например, Check Number, Check Date и Amount, с соответствующими именами API Check_Number, Check_Date и Amount. Выполните данные действия для миграции данного конкретного процесса и адаптируйте логику для миграции собственных процессов обслуживания.

Создайте службу в объединенном каталоге.

Объединенный каталог использует записи Product2 для определения услуг. Создайте эту запись, чтобы создать уникальный код продукта для службы.
1. В средстве запуска приложений найдите и откройте «Объединенный каталог».
2. На начальной странице нажмите «Создать» и выберите «Сервис».
  
  Можно также открыть вкладку «Услуги» и нажать кнопку «Создать службу».
3. Введите «Остановить проверку оплаты» в поле «Имя» и заполните остальные поля.
4. Сохраните внесенные изменения.
В конструкторе услуг в объединенном каталоге выполните данные действия.
1. Нажмите кнопку «Далее».
2. На этапе атрибутов воссоздайте атрибуты исходного определения процесса обслуживания.
  
  В атрибуте «Проверить номер» используйте «Текст» в качестве типа данных. В атрибуте Check Date используйте Date в качестве типа данных. В атрибуте «Стоимость» используйте «Число» в качестве типа данных. См. Настройка атрибутов процесса.
  
  Примечание Обязательно соотнесите API-имя каждого атрибута с API-именем в исходном определении Service Process Studio, чтобы избежать ошибок несоответствия в процессах приема или выполнения.
3. На этапе формы приема вложите форму приема и поток выполнения, которые нужно связать со службой «Остановить проверку оплаты». См. Форма запроса на разработку.
4. На этапе потока выполнения добавьте поток выполнения, который нужно связать со службой «Остановить проверку оплаты». См. Настройка выполнения запроса.
5. В разделе «Расширенные параметры» на этапе «Интеграции» добавьте определения интеграции, которые нужно связать со службой «Остановить проверку оплаты».
6. В URL-адресе обозревателя этой новой службы скопируйте код записи, например 01tDn00000Wxyz.
  01tDn00000Wxyz - это код продукта для службы.
Сохраните изменения и активируйте службу «Остановить проверку оплаты».
Создание трансформации Omnistudio Data Mapper.

Соотнесите данные формы приема со структурой JSON CustomAttributes. Unified Catalog Connect API требует наличия всех сервисных данных, добавленных в определенный узел JSON под названием CustomAttributes. Ваш существующий Omniscript, вероятно, хранит данные в формате плоского ключевого значения, поэтому эта трансформация необходима для корректной структуры полезных данных для API.
1. В созданной трансформации Data Mapper перейдите во вкладку transform.
2. Нажмите «Управление типом ввода/вывода».
3. В поле «Редактировать JSON ввода» введите JSON ввода.
  JSON ввода представляет данные точно так, как они существуют в вашем Omniscript непосредственно перед отправкой запроса процесса обслуживания.
  
  Ниже указан образец структуры ввода JSON для процесса обслуживания «Остановить проверку оплаты»:
```
        {
        "Check_Number": "1042",
        "Check_Date": "2026-02-15",
        "Amount": "2500"
        }
       
```
4. В поле «Редактировать ожидаемый вывод JSON» введите ожидаемый вывод JSON.
  JSON ожидаемого вывода - это формат полезных данных, требуемый Unified Catalog Connect API.
  
  Ниже указан пример ожидаемой структуры вывода JSON с узлом CustomAttributes для процесса обслуживания «Остановить проверку оплаты»:
```
        {
        "CustomAttributes": {
        "checkNumber": "1042",
        "checkDate": "2026-02-15",
        "amount": "2500"
        }
        }
       
```
5. Соотнесите поля ввода Omniscript с соответствующими полями вывода в узле CustomAttributes. См. Соотнесение вводов и вывода для трансформаций.
  
  Ниже указан пример соотнесенных полей ввода и вывода.
Создайте процедуру интеграции мультистудии.

Настройте процедуру интеграции для вызова Unified Catalog Connect API и передачи данных процесса обслуживания. Исходная Service Process Studio использовала Service Process Connect API для создания обращений для запросов сервисных процессов. Объединенный каталог использует API под управлением продукта ServiceRequestCaseApiService. Данный API требует передачи productId для связывания созданного обращения с элементом каталога. Он также требует соотнесения каждого определенного атрибута услуги в качестве отдельной пары ключ-значение. Это гарантирует, что объединенный каталог точно считывает данные приема и структурирует их корректно для записи обращения. Скопируйте имя процедуры интеграции для последующего использования.
1. В созданной процедуре интеграции добавьте этап удаленного действия.
2. Введите serviceprocess.ServiceRequestCaseApiService в качестве удаленного класса.
3. Введите callServiceRequestApiToCreateCase в качестве удаленного метода.
4. Разверните раздел «Дополнительный ввод», «Дополнительный вывод» и «Ответ на сбой».
5. В разделе дополнительного ввода добавьте ключи productId, svcCatalogItemDefApiName и inputToRequestPayloadTransformDataMapper.
6. В качестве ключа productId введите код продукта службы. Например, 01tDn00000Wxyz.
7. В качестве ключа svcCatalogItemDefApiName введите имя службы. Например, «Остановить оплату чека».
8. В качестве ключа inputToRequestPayloadTransformDataMapper введите API-имя созданной трансформации Data Mapper.
9. В этом же разделе «Дополнительный ввод» добавьте каждый атрибут процесса обслуживания в качестве новой пары ключ-значение. Например, задайте ключ «Стоимость» и значение для соотнесения данных из Omniscript с процедурой интеграции.
  
  Ниже указан пример ввода в процедуру интеграции для процесса обслуживания «Остановить проверку оплаты».
Сохраните и активируйте процедуру интеграции.
Обновите Omniscript приема процесса «Остановить проверку платежного обслуживания».
1. Создайте версию существующего Omniscript.
2. Найдите и выберите этап CreateCase, создающий обращение для запроса процесса обслуживания.
3. В свойствах действия процедуры интеграции в поле процедуры интеграции добавьте имя созданной процедуры интеграции.
4. В разделе «Дополнительная полезная нагрузка» добавьте все атрибуты процесса обслуживания в качестве пар ключ-значение.
Активируйте Omniscript.