Exempel: Migrera en serviceprocess till den enhetliga katalogen

Förenkla hur du hanterar intagningsbegäranden genom att konvertera dina serviceprocessdefinitioner i Service Process Studio till standardproduktposter. Hantera alla dina produkt- och serviceerbjudanden på en och samma plats.

Versioner som krävs

Tillgängliga i: Lightning Experience

Tillgängliga i: Enterprise, Unlimited och Developer Editions med Financial Services Cloud och enhetlig katalog.

Innan du börjar, se till att du har en aktiv Stoppa kontroll av betalningstjänstprocess som ursprungligen skapades i Service Process Studio.

Denna uppgift använder tjänstprocessen Stoppa kontroll av betalning som ett exempel för att demonstrera migreringsstegen. I detta scenario innehåller den ursprungliga serviceprocessdefinitionen tre attribut, som Kontrollnummer, Kontrolldatum och Belopp, med motsvarande API-namn som Kontrollnummer, Kontrolldatum och Belopp. Följ dessa steg för att migrera denna specifika process och anpassa logiken för att migrera dina egna serviceprocesser.

Skapa tjänsten i den enhetliga katalogen.

Sammanslagen katalog använder Product2-poster för att definiera tjänster. Skapa denna post för att skapa ett unikt produkt-ID för tjänsten.
1. Sök fram och öppna Samlad katalog i Appstartaren.
2. På Startsidan, klicka på Ny och välj Serviceprocess.
3. För namn, ange Stoppa kontroll av betalning och fyll i återstående fält.
4. Spara dina ändringar.
I servicedesignern i den sammanslagna katalogen, utför dessa åtgärder.
1. Klicka på Nästa.
2. I steget Attribut, återskapa attributen för din ursprungliga serviceprocessdefinition.
  
  För attributet Kontrollera nummer, använd Text som datatyp. För attributet Kontrollera datum, använd Datum som datatyp. För attributet Belopp, använd Nummer som datatyp. Se Konfigurera processattribut.
  
  Anteckning Se till att matcha API-namnet för varje attribut med API-namnet i din ursprungliga Service Process Studio-definition för att förhindra felaktiga matchningar i dina intagnings- eller uppfyllandeprocesser.
3. I steget Intagsformulär, bifoga intagningsformuläret och det uppfyllandeflöde som du vill associera med tjänsten Stoppa kontroll av betalning. Se Intagsformulär för designbegäran.
4. I steget Uppfyllandeflöde, lägg till det uppfyllandeflöde som du vill associera med tjänsten Sluta kontrollera betalning. Se Konfigurera begärandeuppfyllande.
5. Under Avancerade alternativ, i steget Integreringar, lägg till de integreringsdefinitioner som du vill associera med tjänsten Stoppa kontroll av betalning.
6. I webbläsar-URL:en för denna nya tjänst, kopiera post-ID:t, till exempel 01tDn00000Wxyz.
  01tDn00000Wxyz är produkt-ID för tjänsten.
Spara dina ändringar och aktivera tjänsten Sluta kontrollera betalning.
Skapa en Omnistudio Data Mapper-transformation.

Mappa dina intagningsformulärdata till JSON-strukturen CustomAttributes. Sammanslagen Catalog Connect API kräver alla servicespecifika data inbäddade i en specifik JSON-nod som heter CustomAttributes. Ditt befintliga Omniscript lagrar troligen data i ett platt nyckelvärdeformat, så denna transformation är nödvändig för att strukturera nyttolasten korrekt för API.
1. I den Data Mapper-transformation du skapade, gå till fliken Transformera.
2. Klicka på Hantera indata/utdatatyp.
3. I fältet Redigera JSON för indata, ange din JSON för indata.
  JSON för indata representerar data exakt som de finns inuti ditt Omniscript precis innan du skickar in serviceprocessbegäran.
  
  Här är ett exempel på en JSON-struktur för indata för serviceprocessen Stoppa kontroll av betalning:
```
        {
        "Check_Number": "1042",
        "Check_Date": "2026-02-15",
        "Amount": "2500"
        }
       
```
4. I Redigera förväntad JSON-utdata, ange din förväntade JSON-utdata.
  JSON för förväntad utdata är det belastningsformat som Unified Catalog Connect API kräver.
  
  Här är ett exempel på JSON-struktur för förväntad utdata med CustomAttributes-noden för serviceprocessen Stoppa kontroll av betalning:
```
        {
        "CustomAttributes": {
        "checkNumber": "1042",
        "checkDate": "2026-02-15",
        "amount": "2500"
        }
        }
       
```
5. Mappa ditt Omniscripts indatafält till motsvarande utdatafält i noden CustomAttributes. Se Kartinmatningar och utmatningar för transformationer.
  
  Här är ett exempel på de mappade indata- och utdatafälten.
Skapa en Omnistudio-integreringsprocess.

Konfigurera en integreringsprocess för att anropa Unified Catalog Connect API och skicka dina serviceprocessdata. Den ursprungliga Service Process Studio använde Service Process Connect API för att skapa kundcase för serviceprocessbegäranden. Den sammanslagna katalogen använder en produktdriven API som heter ServiceRequestCaseApiService. Detta API kräver att du skickar productId för att länka det nyligen skapade kundcaset till ditt katalogobjekt. Det kräver även att du mappar varje specifikt serviceattribut som ett distinkt nyckelvärdepar. Detta garanterar att den sammanslagna katalogen läser dina intagningsdata korrekt och strukturerar dem korrekt för kundcaseposten. Kopiera namnet på integreringsprocessen för senare användning.
1. I den integreringsprocess du skapade, lägg till ett steg för Fjärråtgärd.
2. Ange serviceprocess.ServiceRequestCaseApiService som fjärrklass.
3. Ange callServiceRequestApiToCreateCase som fjärrmetod.
4. Utöka sektionen Ytterligare indata, Ytterligare utdata och Svar på fel.
5. I sektionen Ytterligare indata, lägg till nyckelarna productId, svcCatalogItemDefApiName och inputToRequestPayloadTransformDataMapper.
6. För productId-nyckeln, ange produkt-ID för tjänsten. Till exempel 01tDn00000Wxyz.
7. För nyckeln svcCatalogItemDefApiName, ange namnet på din tjänst. Till exempel Stoppa en kontrollbetalning.
8. För nyckeln inputToRequestPayloadTransformDataMapper, ange API-namnet på den Data Mapper-transformation som du skapade.
9. I samma sektion för Ytterligare indata, lägg till varje attribut i serviceprocessen som ett nytt nyckelvärdepar. Ange till exempel nyckeln till Belopp och värdet för att mappa data från ditt Omniscript till integreringsprocessen.
  
  Här är ett exempel på indata till integreringsprocessen för serviceprocessen Stoppa kontroll av betalning.
Spara och aktivera integreringsprocessen.
Uppdatera Omniscript för intag av processen Sluta kontrollera betalningstjänst.
1. Skapa en version av ditt befintliga Omniscript.
2. Hitta och välj det CreateCase-steg som skapar kundcaset för serviceprocessbegäran.
3. I Egenskaper för integreringsprocessåtgärd, i fältet Integreringsprocedur, lägg till namnet på den integreringsprocess du skapade.
4. I sektionen Extra belastning, lägg till alla attribut för serviceprocessen som nyckelvärdepar.
Aktivera Omniscript.