Criar um tipo de etapa da execução do serviço

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura
  • Expanda a cobertura dos casos de uso de execução do serviço além daqueles compatíveis com os tipos de etapa no sistema de base. Usando um tipo de etapa da execução do serviço, os proprietários do item do catálogo podem definir várias etapas que fazem parte do processo de execução da solicitação.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Os tipos de etapa a seguir estão disponíveis no sistema base.
    • Tarefa
    • Aprovação personalizada
    • Aprovação do gerente

    Procedimento

    1. Configure um armazenamento de dados para armazenar as informações necessárias para executar a etapa. Essas informações são fornecidas por um proprietário de item do catálogo ao definir o processo de execução de solicitação. Siga um destes procedimentos.
      OpçãoDescrição
      Quando uma entrada adicional é necessária do proprietário do item do catálogo para um tipo de etapa Crie uma tabela estendendo a tabela Etapa da execução do serviço [sc_service_fulfillment_step] e adicione campos para armazenar a entrada adicional. Por exemplo, para criar um tipo de etapa para notificações por e-mail, o ID e o corpo do e-mail são a entrada adicional fornecida pelo proprietário do item do catálogo ao definir as etapas. Portanto, os campos de ID e corpo do e-mail devem ser adicionados à tabela estendida para armazenar a entrada.
      Nota:
      Certifique-se de que a nova tabela tenha ACLs semelhantes à tabela Etapa da execução do serviço [sc_service_fulfillment_step].
      Nota:
      Certifique-se de que a nova tabela tenha o acesso às aplicações canCreate, canUpdate e canRead habilitado.

      Para tabelas que estendem a tabela Etapa da execução do serviço [sc_service_fulfillment_step], o atributo Mestre do domínio deve ser adicionado e seu valor deve ser definido como service_fulfillment_stage. O domínio de uma etapa da execução do serviço é herdado do item do catálogo.

      Quando nenhuma entrada é necessária para um tipo de etapa Use a tabela base Etapa da execução do serviço [sc_service_fulfillment_step]. Por exemplo, a aprovação de um chefe de departamento não requer nenhuma entrada adicional do proprietário do item do catálogo e não precisa de uma nova tabela.
    2. Crie um produtor de registro para armazenar os valores fornecidos pelo proprietário do item do catálogo no armazenamento de dados (tabela base ou tabela estendida) dessa etapa. Para obter informações sobre como criar um produtor de registro, consulte Criar um produtor de registro.
      Nota:
      • O conjunto de variáveis Etapas da execução do serviço - Conjunto de propriedades é adicionado automaticamente ao produtor de registro e não deve ser removido do produtor de registro.
      • Todas as colunas adicionais definidas na tabela estendida devem ter variáveis correspondentes mapeadas no produtor de registro.
      • Configure o formulário Produtor de registro para exibir a opção Permitir edição e o campo Opções de salvamento. Além disso, selecione a opção Permitir edição e defina o valor do campo Opções de salvamento como Salvar no destino.
      • Certifique-se de que o produtor de registro não esteja restrito aos usuários com a função catalog_builder_editor.
    3. Crie um subfluxo para executar uma sequência de ações copiando o subfluxo Modelo: etapas da execução do serviço e definindo seu subfluxo. Para obter informações sobre subfluxos, consulte Subfluxos.
      Tabela 1. Modelo: parâmetros de entrada do subfluxo Etapas da execução do serviço
      Parâmetro Tipo Descrição
      request_item Referência Registro RITM
      service_fulfillment_step_data Referência Registro de dados da etapa. Atualize o estado para um dos seguintes valores antes de encerrar o subfluxo:
      • cancelado(a)
      • falha
      • concluído
      service_fulfillment_step Referência Etapa definida em um item do catálogo. Ele deve se referir a uma tabela na qual o produtor de registro definido na configuração da etapa insere um registro.

      Não atualize o registro da etapa.

      Para obter informações sobre tipos de campo de subfluxo, consulte Tipos de campo.

    4. Crie uma configuração de etapa para definir o comportamento e a exibição de um tipo de etapa da execução do serviço.
      1. Navegar até Catálogo de serviços > Administração de Catálogo > Configurações de etapa do cumprimento do serviço.
      2. Clique em Nova.
      3. No formulário, preencha os campos.
        Tabela 2. Formulário Configuração da etapa da execução do serviço
        Campo Descrição
        Nome Nome da configuração da etapa.
        Aplicação Escopo da aplicação no qual a configuração da etapa é compatível.
        Ativo Opção para habilitar o suporte de execução do serviço para o fluxo.
        Ordem Ordem da configuração da etapa.

        Com base na ordem das configurações da etapa, os tipos de etapa da execução do serviço correspondentes são exibidos na lista na região Etapas da etapa Execução.

        O tipo de etapa correspondente à configuração de etapa com a menor ordem é exibido ao lado da lista e os tipos de etapa para todas as outras configurações de etapa são incluídos na lista com base em sua ordem.

        Figura 1. Ordem de tipos da etapa da execução do serviço
        ordem de tipos de etapas da execução do serviço
        Ocultar Oculta o tipo de etapa correspondente à configuração da etapa na lista na região Etapas da etapa Execução. Nenhum impacto sobre etapas existentes.
        Descrição resumida Descrição da configuração da etapa.
        Produtor Produtor de registro que cria uma instância do tipo de etapa no armazenamento de dados da etapa.
        Subfluxo de execução do serviço Subfluxo acionado durante o processo de execução de solicitação.
        Título dinâmico Texto que deve ser exibido para a etapa da execução do serviço correspondente na região Etapas da etapa Execução. Se você não fornecer nenhum valor, o nome da configuração da etapa será exibido.

        Para exibir texto dinâmico, você pode incluir o nome do campo do armazenamento de dados da etapa (tabela base ou a tabela estendida) onde o produtor de registro associado cria um registro.

        Por exemplo, no sistema base, o campo Título dinâmico da configuração da etapa de aprovação personalizada contém o seguinte valor:Aprovação de ${approval_title}

        Aqui, approval_title é o campo da tabela Etapa de aprovação de execução do serviço [sc_service_fulfillment_approval_step] em que o produtor de registro associado, Adicionar aprovação personalizada, cria um registro.

      4. Clique em Enviar.