Esempio: Migrazione di un processo di assistenza al Catalogo unificato

Semplificare la gestione delle richieste di accettazione convertendo le definizioni dei processi di assistenza in Service Process Studio in record prodotto standard. Gestire tutte le offerte di prodotti e servizi in un'unica posizione.

Versioni (Edition) richieste

Disponibile nelle versioni: Lightning Experience

Disponibile in: Enterprise Edition, Unlimited Edition e Developer Edition con Financial Services Cloud e Catalogo unificato.

Prima di iniziare, assicurarsi di avere un processo di servizio di pagamento Stop Check attivo creato in origine in Service Process Studio.

Questa operazione utilizza il processo di servizio Stop Check Payment come esempio per dimostrare le fasi di migrazione. In questo scenario, la definizione del processo di servizio originale contiene tre attributi, ad esempio Numero di controllo, Data di controllo e Ammontare, con i nomi API corrispondenti Check_Number, Check_Date e Ammontare. Eseguire la seguente procedura per migrare questo processo specifico e adattare la logica per migrare i propri processi di assistenza.

Creare il servizio nel Catalogo unificato.

Il Catalogo unificato utilizza i record Product2 per definire i servizi. Creare questo record per generare un ID prodotto univoco per il servizio.
1. Dal Programma di avvio app, trovare e selezionare Catalogo unificato.
2. Nella pagina iniziale, fare clic su Nuovo e selezionare Servizio.
  
  È anche possibile fare clic sulla scheda Servizi e sul pulsante Nuovo servizio.
3. Come nome, immettere Interrompi pagamento e compilare i campi rimanenti.
4. Salva le modifiche.
Nel Designer di servizi nel Catalogo unificato, eseguire le seguenti azioni.
1. Fai clic su Avanti.
2. Nella fase Attributi, ricreare gli attributi della definizione del processo di servizio originale.
  
  Per l'attributo Numero di controllo, utilizzare Testo come tipo di dati. Per l'attributo Controlla data, utilizzare Data come tipo di dati. Per l'attributo Ammontare, utilizzare Numero come tipo di dati. Vedere Configurazione degli attributi processo.
  
  Nota Assicurarsi di abbinare il nome API di ogni attributo al nome API nella definizione originale di Service Process Studio per evitare errori di mancata corrispondenza nei processi di accettazione o evasione.
3. Nella fase Modulo di accettazione, allegare il modulo di accettazione e il flusso di evasione che si desidera associare al servizio Stop Check Payment. Vedere Modulo Design Request Intake.
4. Nella fase Flusso di evasione, aggiungere il flusso di evasione che si desidera associare al servizio Stop Check Payment. Vedere Configurazione dell'evasione della richiesta.
5. In Opzioni avanzate, nella fase Integrazioni, aggiungere le definizioni integrazione che si desidera associare al servizio Stop Check Payment.
6. Copiare l'ID record nell'URL del browser del nuovo servizio, ad esempio 01tDn00000Wxyz.
  01tDn00000Wxyz è l'ID prodotto del servizio.
Salvare le modifiche e attivare il servizio Stop Check Payment.
Creare una trasformazione OmniStudio Data Mapper.

Mappare i dati del modulo di accettazione alla struttura JSON CustomAttributes. L'API Unified Catalog Connect richiede tutti i dati specifici del servizio racchiusi in un nodo JSON specifico denominato CustomAttributes. Probabilmente l'OmniScript esistente memorizza i dati in un formato chiave-valore flat, quindi questa trasformazione è necessaria per strutturare correttamente il payload per l'API.
1. Nella trasformazione Data Mapper creata, accedere alla scheda Trasforma.
2. Fare clic su Gestisci tipo input/output.
3. Nel campo Modifica JSON input, immettere il JSON di input.
  Il JSON di input rappresenta i dati esattamente come esistono all'interno dell'OmniScript subito prima dell'invio della richiesta di processo di assistenza.
  
  Di seguito è riportato un esempio di struttura JSON di input per il processo di servizio Stop Check Payment:
```
        {
        "Check_Number": "1042",
        "Check_Date": "2026-02-15",
        "Amount": "2500"
        }
       
```
4. In Modifica output JSON previsto, immettere il JSON di output previsto.
  Il JSON Output previsto è il formato di payload richiesto dall'API Unified Catalog Connect.
  
  Di seguito è riportato un esempio di struttura JSON di output prevista con nodo CustomAttributes per il processo di servizio Stop Check Payment:
```
        {
        "CustomAttributes": {
        "checkNumber": "1042",
        "checkDate": "2026-02-15",
        "amount": "2500"
        }
        }
       
```
5. Mappare i campi di input di OmniScript ai campi di output corrispondenti nel nodo CustomAttributes. Vedere Mappatura di input e output per le trasformazioni.
  
  Di seguito è riportato un esempio dei campi di input e output mappati.
Creare una procedura di integrazione OmniStudio.

Configurare una procedura di integrazione per chiamare l'API Unified Catalog Connect e passare i dati del processo di assistenza. Service Process Studio originale utilizzava l'API Service Process Connect per creare casi per le richieste dei processi di assistenza. Il Catalogo unificato utilizza un'API basata sul prodotto denominata ServiceRequestCaseApiService. Questa API richiede di passare il productId per collegare il caso appena creato all'elemento catalogo. Richiede inoltre di mappare ogni attributo di servizio specifico come coppia chiave-valore distinta. Ciò garantisce che il Catalogo unificato legga accuratamente i dati di accettazione e li strutturi correttamente per il record caso. Copiare il nome della procedura di integrazione per utilizzarlo in seguito.
1. Nella procedura di integrazione creata, aggiungere una fase Azione remota.
2. Immettere serviceprocess.ServiceRequestCaseApiService come classe remota.
3. Immettere callServiceRequestApiToCreateCase come metodo remoto.
4. Espandere la sezione Input aggiuntivo, Output aggiuntivo e Risposta all'errore.
5. Nella sezione Input aggiuntivo, aggiungere le chiavi productId, svcCatalogItemDefApiName e inputToRequestPayloadTransformDataMapper.
6. Per la chiave productId, immettere l'ID prodotto del servizio. Ad esempio, 01tDn00000Wxyz.
7. Per la chiave svcCatalogItemDefApiName, immettere il nome del servizio. Ad esempio, Interruzione di un pagamento con assegno.
8. Per la chiave inputToRequestPayloadTransformDataMapper, immettere il nome API della trasformazione Data Mapper creata.
9. Nella stessa sezione Input aggiuntivo, aggiungere ogni attributo del processo di assistenza come nuova coppia chiave-valore. Ad esempio, impostare la chiave su Ammontare e il valore per mappare i dati dell'OmniScript nella procedura di integrazione.
  
  Di seguito è riportato un esempio di input alla procedura di integrazione per il processo di servizio Stop Check Payment.
Salvare e attivare la procedura di integrazione.
Aggiornare l'OmniScript di accettazione del processo di servizio di pagamento Stop Check.
1. Creare una versione dell'OmniScript esistente.
2. Individuare e selezionare la fase CreateCase che crea il caso per la richiesta del processo di assistenza.
3. Nelle proprietà delle azioni della procedura di integrazione, nel campo Procedura di integrazione, aggiungere il nome della procedura di integrazione creata.
4. Nella sezione Payload extra, aggiungere tutti gli attributi del processo di assistenza come coppie chiave-valore.
Attivare l'OmniScript.