Exemplo: Migrar um processo de serviço para o Catálogo unificado

Simplifique como gerenciar solicitações de entrada convertendo suas definições de processo de serviço no Service Process Studio em registros de produto padrão. Gerencie todos os seus produtos e ofertas de serviço juntos em um só lugar.

Edições obrigatórias

Disponível em: Lightning Experience

Disponível em: Edições Enterprise, Unlimited e Developer com o Financial Services Cloud e o Catálogo unificado.

Antes de começar, certifique-se de que você tenha um processo de serviço de pagamento de Parar verificação ativo criado originalmente no Service Process Studio.

Essa tarefa usa o processo de serviço Parar verificação de pagamento como um exemplo para demonstrar as etapas de migração. Nesse cenário, a definição de processo de serviço original contém três atributos, como Número de verificação, Data de verificação e Valor, com os nomes de API correspondentes como Check_Number, Check_Date e Amount. Siga estas etapas para migrar esse processo específico e adaptar a lógica para migrar seus próprios processos de serviço.

Crie o serviço no Catálogo unificado.

O Catálogo unificado usa registros de Product2 para definir serviços. Crie esse registro para gerar um ID de produto exclusivo para o serviço.
1. No Iniciador de aplicativos, localize e selecione Catálogo unificado.
2. Na página inicial, clique em Novo e selecione Processo de serviço.
3. Para nome, insira Parar pagamento de verificação e preencha os campos restantes.
4. Salve suas alterações.
No designer de serviços no Catálogo unificado, execute estas ações.
1. Clique em Avançar.
2. Na etapa Atributos, recrie os atributos da sua definição de processo de serviço original.
  
  Para o atributo Verificar número, use Texto como o tipo de dados. Para o atributo Verificar data, use Data como o tipo de dados. Para o atributo Valor, use Número como o tipo de dados. Consulte Configurar atributos do processo.
  
  Nota Certifique-se de combinar o nome da API de cada atributo com o nome da API em sua definição original do Service Process Studio para evitar erros de incompatibilidade em seus processos de recebimento ou cumprimento.
3. Na etapa Formulário de admissão, anexe o formulário de admissão e o fluxo de cumprimento que você deseja associar ao serviço Parar pagamento de verificação. Consulte Design Request Admission Form.
4. Na etapa Fluxo de cumprimento, adicione o fluxo de cumprimento que você deseja associar ao serviço Parar pagamento de verificação. Consulte Configurar cumprimento da solicitação.
5. Em Opções avançadas, na etapa Integrações, adicione as definições de integração que você deseja associar ao serviço Parar verificação de pagamento.
6. No URL do navegador desse novo serviço, copie o ID do registro, por exemplo, 01tDn00000Wxyz.
  01tDn00000Wxyz é o ID do produto para o serviço.
Salve suas alterações e ative o serviço Parar pagamento de verificação.
Criar uma transformação do Mapeador de dados do OmniStudio.

Mapeie os dados do formulário de entrada para a estrutura JSON CustomAttributes. A API do Catálogo unificado do Connect exige que todos os dados específicos do serviço sejam agrupados em um nó JSON específico chamado CustomAttributes. Seu OmniScript existente provavelmente armazena dados em um formato de valor de chave simples, portanto, essa transformação é necessária para estruturar a carga útil corretamente para a API.
1. Na Transformação do mapeador de dados que você criou, acesse a guia Transformação.
2. Clique em Gerenciar tipo de entrada/saída.
3. No campo Editar JSON de entrada, insira seu JSON de entrada.
  O JSON de entrada representa os dados exatamente como existem dentro do OmniScript diretamente antes do envio da solicitação de processo de serviço.
  
  Aqui está uma estrutura JSON de entrada de amostra para o processo de serviço Parar verificação de pagamento:
```
        {
        "Check_Number": "1042",
        "Check_Date": "2026-02-15",
        "Amount": "2500"
        }
       
```
4. Na saída Editar JSON esperado, insira seu JSON de saída esperado.
  O JSON de saída esperada é o formato de carga útil exigido pela API do Catálogo unificado do Connect.
  
  Aqui está uma estrutura JSON de saída esperada de amostra com o nó CustomAttributes para o processo de serviço Parar verificação de pagamento:
```
        {
        "CustomAttributes": {
        "checkNumber": "1042",
        "checkDate": "2026-02-15",
        "amount": "2500"
        }
        }
       
```
5. Mapeie os campos de entrada do OmniScript para os campos de saída correspondentes no nó CustomAttributes. Consulte Mapear entradas e saídas para transformações.
  
  Aqui está um exemplo dos campos de entrada e saída mapeados.
Crie um Procedimento de integração do OmniStudio.

Configure um Procedimento de integração para chamar a API do Catálogo unificado Connect e passar seus dados de processo de serviço. O Service Process Studio original usava a API do Service Process Connect para criar casos para as solicitações de processo de serviço. O Catálogo unificado usa uma API orientada por produto chamada ServiceRequestCaseApiService. Essa API exige que você passe o productId para vincular o caso recém-criado ao item do seu catálogo. Também exige que você mapeie cada atributo de serviço específico como um par de chave e valor distintos. Isso garante que o Catálogo unificado leia com precisão seus dados de entrada e os estruture corretamente para o registro de caso. Copie o nome do Procedimento de integração para uso posterior.
1. No Procedimento de integração que você criou, adicione uma etapa de Ação remota.
2. Insira serviceprocess.ServiceRequestCaseApiService como a classe remota.
3. Insira callServiceRequestApiToCreateCase como o método remoto.
4. Expanda a seção Entrada adicional, Saída adicional e Resposta de falha.
5. Na seção Entrada adicional, adicione as chaves productId, svcCatalogItemDefApiName e inputToRequestPayloadTransformDataMapper.
6. Para a chave productId, insira o ID do produto do serviço. Por exemplo, 01tDn00000Wxyz.
7. Para a chave svcCatalogItemDefApiName, insira o nome do seu serviço. Por exemplo, Parar um pagamento de cheque.
8. Para a chave inputToRequestPayloadTransformDataMapper, insira o nome da API da Transformação do mapeador de dados que você criou.
9. Na mesma seção Entrada adicional, adicione cada atributo do processo de serviço como um novo par de chave e valor. Por exemplo, defina a chave como Valor e o valor para mapear os dados do OmniScript para o Procedimento de integração.
  
  Aqui está um exemplo de entrada para o Procedimento de integração para o processo de serviço Parar verificação de pagamento.
Salve e ative o Procedimento de integração.
Atualize o OmniScript de entrada do processo de serviço de pagamento de verificação de parada.
1. Crie uma versão do seu OmniScript existente.
2. Localize e selecione a etapa CreateCase que cria o caso para a solicitação de processo de serviço.
3. Nas Propriedades da ação do procedimento de integração, no campo Procedimento de integração, adicione o nome do procedimento de integração que você criou.
4. Na seção Carga útil extra, adicione todos os atributos do processo de serviço como pares de chave e valor.
Ative o OmniScript.