Transferência de definição de serviço de uma instância para outra

Versão de lançamento: Xanadu

Atualizado 1 de ago. de 2024

6 min. de leitura

Economize tempo e esforço exportando definições de serviços de aplicativos da instância de origem e importando essas definições na instância de destino. Você pode usar este método para copiar definições de serviços de aplicativo somente do tipo descoberto.

Normalmente, você mantém duas instâncias ServiceNow em sua organização: para produção e para desenvolvimento. Execute o mapeamento inicial de serviços de aplicações em sua organização na instância de desenvolvimento que você usa para testes. Os resultados do mapeamento inicial geralmente exigem algumas soluções de problemas básicos ou ajustes finos. Quando terminar de mapear serviços de aplicações em sua instância de origem, transfira as definições de serviço para a instância de destino (produção).

Observe que você não pode exportar os serviços de aplicações reais, somente as definições de serviço. O mapeamento é um processo dinâmico e o resultado do mapeamento reflete a infraestrutura real e sua configuração. Portanto, os serviços que você exportou de uma instância e importou para outra podem ter uma aparência diferente.

Por padrão, você exporta as seguintes definições de serviço:

Nome do serviço
Uso da Descoberta com base no tráfego
Ponto de entrada
Criticalidade dos negócios
Grupo ao qual o serviço pertence
Se este grupo de serviço fizer parte de uma hierarquia de grupo de serviço, todos os grupos de serviço primários nessa hierarquia também serão exportados.
Comentários

O sistema usa o atributo SYS ID [sys_id] para identificar serviços nas instâncias de origem e de destino e implementa a importação de definição de serviço de acordo com estas regras:

Se um SYS ID de serviço não existir na instância de destino, o sistema criará um novo serviço na instância de destino.
Se um SYS ID e um nome de serviço já existirem na instância de destino, o sistema atualizará esse serviço substituindo as definições de serviço existentes pelas definições importadas.
Se houver um SYS ID de serviço na instância de destino, mas estiver associado a um nome de serviço diferente, o sistema atualizará o serviço com esse SYS ID. O sistema substitui as definições de serviço, incluindo o nome do serviço.
Se o mesmo nome for usado para diferentes serviços nas instâncias de origem e de destino, o sistema não importará as definições de serviço.
Você não pode exportar serviços manuais. Da mesma forma, você não pode exportar pontos de entrada adicionados manualmente. Ao importar definições de um serviço que contém pontos de entrada manuais, o sistema não faz mudanças nos pontos de entrada.

Exportando definições de serviço. — Figura 1. Exportando fluxo de definições de serviço

Ao transferir definições de serviços entre as instâncias, os grupos de serviço e os serviços de aplicativos importados são atribuídos ao domínio do usuário.

Por padrão, o sistema atribui o status Non-operational aos serviços de aplicações cujas definições você importou.

Uma transferência de definição de serviço implanta o recurso de conjunto de importação padrão disponível no Now Platform. Quando você exporta definições de serviço na instância de origem, o sistema cria um arquivo JSON que contém os dados exportados. Ao copiar definições de serviço para a instância de destino, você importa os dados deste arquivo JSON, que se torna um conjunto de importação.

Exportar definições de serviço

Crie um conjunto de importação que contém definições de serviços. Você usa este conjunto de importação para importar definições de serviço para outra instância.

Antes de Iniciar

Decida quais definições de serviço você deseja exportar.
Importante:
Você pode usar este método para copiar definições de aplicações atendidas somente do tipo descoberto.
Verifique se as instâncias de origem e de destino estão na mesma versão ServiceNow.
Abra a instância de origem da qual você deseja copiar as definições de serviço.
Se necessário, ajuste com precisão a criação do conjunto de importação modificando as propriedades relevantes em Mapeamento de serviços > Administração > Propriedades. Para obter mais informações, consulte Componentes instalados com Mapeamento de serviços..

Função necessária: service_mapping_admin

Procedimento

Se a instância usar separação de domínio e você tiver acesso ao domínio global, selecione o domínio ao qual o Serviço de aplicações pertence no seletor de domínio ( Seletor de ).
O domínio selecionado deve ser um domínio sem domínios secundários.
Navegar até Mapeamento de serviços > Serviços > Serviços de aplicações.
Selecione os serviços de aplicações que você deseja exportar.
Clique em Ações nas linhas selecionadas na parte inferior da página e selecione Exportar serviços.
O conjunto de importação aparece na pasta Downloads. O nome do arquivo segue esta convenção: export_service_<datetime> .json.
Se necessário, copie o conjunto de importação para um local diferente no computador.

Importar definições de serviço de uma instância para outra

Importe definições de serviços de aplicações da instância de origem.

Antes de Iniciar

Verifique se as instâncias de origem e de destino estão na mesma versão ServiceNow.
Abra a instância de destino para a qual você deseja importar definições de serviço.

Função necessária: import_admin

Procedimento

Se a instância usar separação de domínio e você tiver acesso ao domínio global, selecione o domínio ao qual o Serviço de aplicações pertence no seletor de domínio ( Seletor de ).
O domínio selecionado deve ser um domínio sem domínios secundários.
Navegar até Mapeamento de serviços > Serviços > Importar Definições de Serviço.
Na janela Importar definições de serviço, clique em Escolher arquivo, navegue até o arquivo JSON que contém as definições de serviço e clique em OK.
Opcional: Clique em Mostrar visualização e verifique as definições no arquivo JSON escolhido.
Clique em Importar.
Clique em Sim para confirmar que você está pronto para importar definições de serviço.

Importante:
Durante a importação, o sistema substitui de forma irreversível as definições atuais de serviço.

A janela Andamento exibe a mensagem de sucesso.

Mapeamento de serviços O inicia automaticamente a descoberta de serviços que contêm pontos de entrada importados.
Revise os serviços importados ou atualizados depois que Mapeamento de serviços terminar o processo de mapeamento.
Se o resultado da transferência não for o esperado, execute a solução de problemas básica conforme descrito na tabela a seguir.


Sintoma	Causa	Solução
As mudanças que você fez recentemente em um Serviço de aplicações desaparecem.	As definições de serviços de aplicações existentes são sempre substituídas durante a transferência.	Faça as mudanças necessárias nas definições deste Serviço de aplicações novamente. Execute a descoberta de cima para baixo deste Serviço de aplicações clicando em Executar Descoberta no mapa de serviço.
Um grupo de serviço importado não aparece.	A importação de um serviço de aplicativos atribuído a este grupo falhou e o sistema não criou o grupo porque ele parece estar vazio.	Resolva o problema que impedia o sistema de importar Serviço de aplicações pertencente a este grupo. Importe o conjunto de importação novamente. Verifique se o grupo de serviço aparece.
Um grupo de serviço importado parece ter serviços de aplicações incorretos atribuídos a ele.	Este é um grupo de serviço diferente com o mesmo nome, não o grupo de serviço que você importou. O sistema falhou ao importar o grupo de serviço porque a instância de origem já tem um grupo de serviço com o mesmo nome ou com o mesmo nome e SYS ID.	Verifique o log de importação. Se um erro informar que uma criação de registro falhou durante a execução da regra de negócio Verificar exclusividade de nome, execute as seguintes etapas: Renomeie o grupo de serviço na instância de origem. Exporte novamente os serviços de aplicações atribuídos a este grupo. Importe o conjunto de importação mais recente na instância de destino. Se um erro informar que a criação de um registro falhou porque o SYS ID já existe, execute as seguintes etapas: Recrie o grupo de serviço na instância de origem, certificando-se de fornecer um nome de grupo e SYS ID diferentes para ele. Re-exporta os serviços de aplicações atribuídos a este grupo. Importe o conjunto de importação mais recente na instância de destino. Verifique se o grupo de serviço aparece corretamente na instância de origem.