Eksempel: Migrer en serviceproces til det forenede katalog

Gør det nemt, hvordan du administrerer registreringsanmodninger ved at konvertere dine serviceprocesdefinitioner i Service Process Studio til standardproduktregistreringer. Administrer alle dine produkt- og servicetilbud på et sted.

EditionsHeading

Tilgængelig i: Lightning Experience

Tilgængelig i: Enterprise, Unlimited og Developer Edition med Financial Services Cloud og Unified Catalog.

Før du går i gang, skal du sørge for, at du har en aktiv Stop kontrol-betalingstjenesteproces, der oprindeligt blev oprettet i Service Process Studio.

Denne opgave bruger serviceprocessen Stop kontrolbetaling som et eksempel til at demonstrere migreringstrinene. I dette scenarie indeholder den oprindelige serviceprocesdefinition tre attributter, f.eks. Kontrolnummer, Kontroldato og Beløb med deres tilsvarende API-navne som Check_Number, Check_Date og Beløb. Følg disse trin for at migrere denne specifikke proces, og tilpas logikken til at migrere dine egne serviceprocesser.

Opret tjenesten i det forenede katalog.

Forenet katalog bruger Product2-registreringer til at definere tjenester. Opret denne registrering for at generere et entydigt produkt-id for tjenesten.
1. Fra Appstarter skal du finde og vælge Forenet katalog.
2. På startsiden skal du klikke på Ny og vælge Serviceproces.
3. For navn skal du skrive Stop kontrol betaling og udfylde de resterende felter.
4. Gem dine ændringer.
Udfør disse handlinger i Service Designer på det forenede katalog.
1. Klik på Næste
2. I attributtrinnet skal du genoprette attributterne for din oprindelige definition på serviceproces.
  
  For attributten Kontroller tal skal du bruge Tekst som datatype. For attributten Check Date (Kontroldato) skal du bruge Date (Dato) som datatype. For attributten Beløb skal du bruge Tal som datatype. Se Konfigurer procesattributter.
  
  Bemærk Sørg for at matche API-navnet på hver attribut med API-navnet i din oprindelige Service Process Studio-definition for at forhindre uoverensstemmelsesfejl i dine registrerings- eller fuldførelsesprocesser.
3. I trinnet Registreringsformular skal du vedhæfte registreringsformularen og det fuldførelsesforløb, som du ønsker at knytte til tjenesten Stop betalingskontrol. Se Formular til designanmodning.
4. I fuldførelsesforløbstrinnet skal du tilføje det fuldførelsesforløb, som du ønsker at knytte til tjenesten Stop betalingskontrol. Se Konfigurer anmodningsfuldførelse.
5. Under Avancerede indstillinger i trinnet Integrationer skal du tilføje de integrationsdefinitioner, som du ønsker at knytte til tjenesten Stop betalingskontrol.
6. I browser-URL'en for denne nye tjeneste skal du kopiere registrerings-id'et, f.eks. 01tDn00000Wxyz.
  01tDn00000Wxyz er produkt-id'et for tjenesten.
Gem dine ændringer, og aktiver tjenesten Stop betalingskontrol.
Opret en Omnistudio Data Mapper-transformation.

Tilknyt dine registreringsformulardata til CustomAttributes JSON-strukturen. Unified Catalog Connect API kræver alle servicespecifikke data, der er pakket ind i en specifik JSON-node ved navn CustomAttributes. Dit eksisterende Omniscript lagrer sandsynligvis data i et fladt nøgleværdiformat, så denne transformation er nødvendig for at strukturere dataene korrekt for API.
1. I den datatilknytningstransformation, som du oprettede, skal du gå til fanen Transformer.
2. Klik på Administrer input/output type.
3. I feltet Rediger input-JSON skal du angive din input-JSON.
  Input-JSON repræsenterer dataene nøjagtigt, som de findes i dit Omniscript, lige før du indsender serviceprocesanmodningen.
  
  Her er der en eksempel på input-JSON-struktur for serviceprocessen Stop betalingskontrol:
```
        {
        "Check_Number": "1042",
        "Check_Date": "2026-02-15",
        "Amount": "2500"
        }
       
```
4. I Rediger forventet JSON-output skal du angive dit forventede output-JSON.
  Expected Output JSON er det dataformat, som Unified Catalog Connect API kræver.
  
  Her er der et eksempel på en forventet output-JSON-struktur med CustomAttributes-noden for Serviceprocessen Stop betalingskontrol:
```
        {
        "CustomAttributes": {
        "checkNumber": "1042",
        "checkDate": "2026-02-15",
        "amount": "2500"
        }
        }
       
```
5. Tilknyt din Omniscripts inputfelter til de tilsvarende outputfelter i CustomAttributes-noden. Se Tilknyt input og output for transformationer.
  
  Her er et eksempel på de tilknyttede input- og outputfelter.
Opret en Omnistudio-integrationsprocedure.

Konfigurer en integrationsprocedure for at kalde Unified Catalog Connect API og overføre dine serviceprocesdata. Det oprindelige Service Process Studio brugte Service Process Connect API til at oprette sager for serviceprocesanmodninger. Det forenede katalog bruger en produktstyret API ved navn ServiceRequestCaseApiService. Denne API kræver, at du overfører productId for at linke den netop oprettede sag til dit katalogelement. Det kræver også, at du tilknytter hver specifik serviceattribut som et særskilt nøgle-værdi-par. Dette garanterer, at det forenede katalog nøjagtigt læser dine registreringsdata og strukturerer dem korrekt for sagsregistreringen. Kopier navnet på integrationsproceduren til senere brug.
1. Tilføj et fjernhandlingstrin i den integrationsprocedure, som du oprettede.
2. Angiv serviceprocess.ServiceRequestCaseApiService som fjernklassen.
3. Angiv callServiceRequestApiToCreateCase som fjernmetode.
4. Udvid afsnittet Yderligere input, Yderligere output og Fejlsvar.
5. Tilføj nøglerne productId, svcCatalogItemDefApiName og inputToRequestPayloadTransformDataMapper i afsnittet Yderligere input.
6. For productId-nøglen skal du angive tjenesteens produkt-id. F.eks. 01tDn00000Wxyz.
7. For svcCatalogItemDefApiName-nøglen skal du angive navnet på din tjeneste. F.eks. Stop en kontrolbetaling.
8. For inputToRequestPayloadTransformDataMapper-nøglen skal du angive API-navnet på den Data Mapper-transformation, som du oprettede.
9. Tilføj hver attribut for serviceprocessen som et nyt nøgle-værdi-par i det samme afsnit Yderligere input. Indstil f.eks. nøglen til Beløb og værdien til at tilknytte dataene fra dit Omniscript til integrationsproceduren.
  
  Her er der et eksempelinput til integrationsproceduren for serviceprocessen Stop betalingskontrol.
Gem og aktiver integrationsproceduren.
Opdater registrerings-Omniscript for processen Stop betalingskontrol.
1. Opret en version af dit eksisterende Omniscript.
2. Find og vælg CreateCase-trinnet, der opretter sagen for serviceprocesanmodningen.
3. I egenskaberne for integrationsprocedurehandlinger i feltet Integrationsprocedure skal du tilføje navnet på den integrationsprocedure, som du oprettede.
4. Tilføj alle attributterne for serviceprocessen som nøgle-værdi-par i afsnittet Ekstra data.
Aktiver Omniscript.