Voorbeeld: Een serviceproces migreren naar de gecombineerde catalogus

Vereenvoudig de manier waarop u intakeaanvragen beheert door uw serviceprocesdefinities in Service Process Studio te converteren naar standaardproductrecords. Beheer al uw product- en serviceaanbiedingen samen op één plaats.

Vereiste editions

Beschikbaar in: Lightning Experience

Beschikbaar in: Enterprise, Unlimited en Developer Edition met Financial Services Cloud en Gecombineerde catalogus.

Zorg er voordat u begint voor dat u een actief betalingsserviceproces Stopcontrole hebt dat oorspronkelijk is gemaakt in Service Process Studio.

Deze taak gebruikt het serviceproces Betaling controleren stoppen als voorbeeld om de migratiestappen te demonstreren. In dit scenario bevat de oorspronkelijke serviceprocesdefinitie drie kenmerken, zoals Controlenummer, Controledatum en Bedrag, met hun overeenkomende API-namen Check_Number, Check_Date en Bedrag. Volg deze stappen om dit specifieke proces te migreren en pas de logica aan om uw eigen serviceprocessen te migreren.

Maak de service in de gecombineerde catalogus.

Gecombineerde catalogus gebruikt Product2-records om services te definiëren. Maak deze record om een unieke product-ID voor de service te genereren.
1. Zoek en selecteer vanuit de Appstarter Gecombineerde catalogus.
2. Klik op de hoofdpagina op Nieuw en selecteer Service.
  
  U kunt ook op het tabblad Services klikken en op de knop Nieuwe service klikken.
3. Geef bij naam Betaling stoppen op en vul de resterende velden in.
4. Sla uw wijzigingen op.
Voer in de serviceontwerper voor de gecombineerde catalogus deze acties uit.
1. Klik op Volgende.
2. Maak in de stap Kenmerken de kenmerken van uw oorspronkelijke serviceprocesdefinitie opnieuw.
  
  Gebruik voor het kenmerk Getal controleren Tekst als gegevenstype. Gebruik voor het kenmerk Datum controleren Datum als gegevenstype. Gebruik Getal als gegevenstype voor het kenmerk Bedrag. Zie Proceskenmerken configureren.
  
  Opmerking Zorg ervoor dat de API-naam van elk kenmerk overeenkomt met de API-naam in uw oorspronkelijke Service Process Studio-definitie om fouten bij overeenkomsten in uw intake- of leveringsprocessen te voorkomen.
3. Voeg bij de stap Intakeformulier het intakeformulier en de leveringsstroom bij die u wilt koppelen aan de service Betaling stoppen. Zie Intakeformulier ontwerpaanvraag.
4. Voeg in de stap Leveringsstroom de leveringsstroom toe die u wilt koppelen aan de service Betaling stoppen. Zie Vervulling van verzoek configureren.
5. Voeg onder Geavanceerde opties in de stap Integraties de integratiedefinities toe die u wilt koppelen aan de service Betaling stoppen.
6. Kopieer in de browser-URL van deze nieuwe service de record-ID, bijvoorbeeld 01tDn00000Wxyz.
  01tDn00000Wxyz is de product-ID voor de service.
Sla uw wijzigingen op en activeer de service Betaling stoppen.
Maak een Omnistudio Data Mapper-transformatie.

Wijs de gegevens van uw intakeformulier toe aan de JSON-structuur CustomAttributes. De Connect-API voor de gecombineerde catalogus vereist alle servicespecifieke gegevens die zijn opgenomen in een specifiek JSON-knooppunt met de naam CustomAttributes. Uw bestaande Omniscript slaat gegevens waarschijnlijk op in een indeling met platte sleutelwaarden, waardoor deze transformatie noodzakelijk is om de payload correct te structureren voor de API.
1. Ga in de Data Mapper-transformatie die u hebt gemaakt, naar het tabblad Transformatie.
2. Klik op Invoer-/uitvoertype beheren.
3. Geef in het veld Invoer-JSON bewerken uw invoer-JSON op.
  De invoer-JSON vertegenwoordigt de gegevens exact zoals deze voorkomen in uw Omniscript vlak voordat u de serviceprocesaanvraag indient.
  
  Hier is een voorbeeld van een invoer-JSON-structuur voor het serviceproces Betaling stoppen:
```
        {
        "Check_Number": "1042",
        "Check_Date": "2026-02-15",
        "Amount": "2500"
        }
       
```
4. Geef in Verwachte JSON-uitvoer bewerken uw verwachte uitvoer-JSON op.
  De verwachte uitvoer-JSON is de payloadindeling die de Connect-API voor de gecombineerde catalogus vereist.
  
  Hier is een voorbeeld van een verwachte uitvoer-JSON-structuur met CustomAttributes-knooppunt voor het serviceproces Betaling stoppen:
```
        {
        "CustomAttributes": {
        "checkNumber": "1042",
        "checkDate": "2026-02-15",
        "amount": "2500"
        }
        }
       
```
5. Wijs de invoervelden van uw Omniscript toe aan de overeenkomende uitvoervelden in het CustomAttributes-knooppunt. Zie Invoer en uitvoer toewijzen voor transformaties.
  
  Hier is een voorbeeld van de toegewezen invoer- en uitvoervelden.
Maak een Omnistudio-integratieprocedure.

Configureer een integratieprocedure om de Connect-API voor de gecombineerde catalogus aan te roepen en uw serviceprocesgegevens door te geven. De oorspronkelijke Service Process Studio gebruikte de Service Process Connect-API om cases te maken voor de serviceprocesverzoeken. De gecombineerde catalogus gebruikt een productgestuurde API met de naam ServiceRequestCaseApiService. Deze API vereist dat u de productId doorgeeft om de zojuist gemaakte case te koppelen aan uw catalogusitem. Ook moet u elk specifiek servicekenmerk toewijzen als een afzonderlijk sleutel-waardepaar. Dit garandeert dat de Gecombineerde catalogus uw intakegegevens nauwkeurig leest en deze correct structureert voor de caserecord. Kopieer de naam van de integratieprocedure voor later gebruik.
1. Voeg in de integratieprocedure die u hebt gemaakt, een stap Externe actie toe.
2. Geef serviceprocess.ServiceRequestCaseApiService op als de externe klasse.
3. Geef callServiceRequestApiToCreateCase op als de externe methode.
4. Vouw de secties Extra invoer, Extra uitvoer en Reactie op mislukking uit.
5. Voeg in de sectie Extra invoer de sleutels productId, svcCatalogItemDefApiName en inputToRequestPayloadTransformDataMapper toe.
6. Geef voor de productId-sleutel de product-ID van de service op. Bijvoorbeeld 01tDn00000Wxyz.
7. Geef voor de sleutel svcCatalogItemDefApiName de naam van uw service op. Bijvoorbeeld Een betaling controleren stoppen.
8. Geef voor de sleutel inputToRequestPayloadTransformDataMapper de API-naam op van de Data Mapper-transformatie die u hebt gemaakt.
9. Voeg in dezelfde sectie Aanvullende invoer elk kenmerk van het serviceproces toe als een nieuw sleutel-waardepaar. Stel bijvoorbeeld de sleutel in op Bedrag en de waarde om de gegevens uit uw Omniscript toe te wijzen aan de integratieprocedure.
  
  Hier is een voorbeeld van invoer voor de integratieprocedure voor het serviceproces Betaling stoppen.
Sla de integratieprocedure op en activeer deze.
Werk het intake Omniscript van het proces Betalingsservice stoppen bij.
1. Maak een versie van uw bestaande Omniscript.
2. Zoek en selecteer de CreateCase-stap die de case voor de serviceprocesaanvraag maakt.
3. Voeg in Eigenschappen van actie voor integratieprocedure in het veld Integratieprocedure de naam toe van de integratieprocedure die u hebt gemaakt.
4. Voeg in de sectie Extra belasting alle kenmerken van het serviceproces toe als sleutel-waardeparen.
Activeer het Omniscript.