Converter serviços manuais em serviços de aplicações usando a API

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura
  • Você pode usar uma API JavaScript para converter serviços manuais existentes em serviços de aplicações. Gestão de eventos pode usar serviços de aplicações para monitorar o desempenho do serviço e identificar problemas de integridade.

    Os serviços manuais não são mais compatíveis e este tipo de serviço, bem como os serviços descobertos, foram substituídos por serviços de aplicações. Todos os serviços manuais existentes devem ser convertidos em serviços de aplicações. Certifique-se de que qualquer automação de serviços manuais (como regras de negócio ou trabalhos agendados) tenha sido criada e testada antes de converter para serviços de aplicações.
    Nota:
    Os serviços manuais são estáticos e mantêm sua estrutura original após a conversão para serviços de aplicações. Para atualizar serviços manuais importados com o estado existente do CMDB, preencha os serviços manuais originais para garantir que todos os ICs sejam atribuídos ao serviço correto ou execute a atualização com a opção de mudanças do CMDB após a conversão.
    Durante o processo de conversão:
    • O registro de serviço manual é movido da tabela Serviços manuais [cmdb_ci_service_manual] para a tabela Serviço de aplicações mapeadas [cmdb_ci_service_discovered] alterando a classe do registro.
    • Todos os atributos de serviço manual originais, como nome, proprietário e status operacional, são mantidos nos serviços de aplicações.
    • Os itens de configuração (ICs) do serviço manual são retidos nos serviços de aplicações após a conversão.
    • O sistema consulta o CMDB para obter as mudanças de IC mais recentes e aplica regras de impacto de IC.
    O número máximo de conexões de IC adicionadas aos serviços de aplicativo durante essa operação é controlado pela propriedade sa.service_max_ci_service_population. Por padrão, o valor é 1.000 (mil conexões). Aumentar o número de conexões de IC pode causar problemas de desempenho. Para ajustar o número máximo de conexões de IC adicionadas, adicione a propriedade sa.service_max_ci_service_population, conforme descrito em Adicionar uma propriedade do sistema.

    A tentativa de processar mais ICs do que o valor especificado na propriedade sa.service_max_ci_service_population causa falha na operação.

    Execute o processo de conversão em pequenos blocos de aproximadamente 10 por vez, para facilitar a identificação do serviço problemático em caso de problema de conversão.

    Os serviços de aplicações não são compatíveis com estes tipos de IC:
    • cmdb_ci_endpoint
    • cmdb_ci_translation_rule
    • cmdb_ci_config_file
    • cmdb_ci_qualifier
    • cmdb_ci_application_cluster
    Se os tipos de IC anteriores forem usados no serviço manual que você deseja converter, a conversão falhará. ICs deste tipo devem ser removidos antes da conversão. Eles podem ser substituídos adicionando novos ICs aos serviços de aplicações após a conversão.

    Se sua instância ServiceNow usar separação de domínio, a conversão falhará se ICs de vários domínios estiverem no mesmo serviço. Substitua ou remova ICs relevantes antes da conversão. Os serviços de aplicações convertidos contêm somente ICs atribuídos ao mesmo domínio que os serviços de aplicações.

    A API JavaScript é:

    BusinessServiceManager.migrateManualToApplicationService(String service_id)
    Tabela 1. Parâmetros
    Nome Tipo Descrição
    service_id Cadeia de caracteres sys_id do serviço manual a ser convertido
    Tabela 2. Retorna
    Tipo Descrição
    Booliano verdadeiro para uma conversão bem-sucedida, falso para uma conversão que falhou
    Onde o sys_id de um serviço manual existente for 451047c6c0a8016400de0ae6df9b9d76, execute a seguinte API para convertê-lo em serviços de aplicações:
    var bsManager = new SNC.BusinessServiceManager();
    var res = bsManager.migrateManualToApplicationService("451047c6c0a8016400de0ae6df9b9d76");