Testar um exportador e exportar um snapshot

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura
  • Defina e valide as configurações de entrada para testar um exportador antes de exportar os dados de configuração em um snapshot.

    Antes de Iniciar

    Importante:
    A partir da versão Washington DC, o Configuração de DevOps está sendo preparado para descontinuação futura. Ele ficará oculto e não será mais instalado em novas instâncias, mas continuará sendo compatível. Para obter detalhes, consulte o artigo Deprecation Process (Processo de descontinuação) [KB0867184] na Base de conhecimento do Now Support.
    Função necessária: cdm_exportador_editor ou cdm_editor ou cdm_admin
    • A função cdm_secrets é necessária para exportar snapshots que incluem dados criptografados.
    • O cdm_viewer pode exportar qualquer snapshot que não inclua dados criptografados.
    • O cdm_exporter_editor pode criar, editar, publicar e excluir exportadores.

    Por Que e Quando Desempenhar Esta Tarefa

    Certifique-se de instalar o pacote de conteúdo do exportador para Configuração de DevOps. Os exportadores no pacote de conteúdo são bons pontos de partida para seus exportadores personalizados. Alguns exportadores de pacote de conteúdo geram subconjuntos de dados de configuração e outros geram dados para aplicações completas. Por exemplo, para exportar dados de configuração atualizados para um banco de dados, você pode selecionar o exportador retornoAllDataforNodeName. Nos argumentos de entrada do exportador, você especificaria o banco de dados implantável como o nó e, em seguida, especificaria as configurações atualizadas como argumentos de entrada. Depois de determinar que as configurações geram os dados de configuração desejados, você pode exportar os dados para o pipeline.

    • Os exportadores no pacote de conteúdo têm o valor de Origem da ServiceNow. Você pode duplicar, mas não pode excluir ou modificar exportadores de pacote de conteúdo.
    • Você pode executar somente exportadores publicados.
    • Para exportação, os snapshots não podem exceder 10.000 itens de dados de configuração (CDIs) por implantável ou 100.000 CDIs por aplicação.
    • Para obter informações sobre como criar um exportador personalizado, consulte Criar um exportador personalizado.
    • Os registros de execuções do exportador são excluídos após um período de três anos. Para obter instruções sobre como alterar o período padrão, consulte Definir o período de limpeza para registros de execuções do exportador.

    Procedimento

    1. Selecione o ícone do administrador ( ícone do administrador) para abrir a página Administração.
    2. Na guia Exportadores, selecione o nome do exportador.
      Dica:
      Adicione exportadores usados com frequência à lista Meus exportadores para acesso rápido.
    3. Selecione a versão do exportador na guia Versões.
      O exportador é aberto na guia Construtor do exportador. O texto do script do exportador aparece em um painel somente exibição. Use o painel Playground de teste para especificar o snapshot a ser exportado e testar as configurações antes de exportar os dados de configuração.
    4. Especifique as configurações para a execução do exportador na página Selecionar entradas.
      Tabela 1. Testar configurações do playground
      Campo Descrição
      Snapshot implantável e publicado a ser exportado

      Implantável para exportação e o snapshot específico publicado que você validou e deseja usar.

      Os implantáveis aparecem na lista usando o formato<AppName/DeployableName> . Quando você seleciona um implantável, outro campo lista todos os snapshots publicados para o implantável. O snapshot publicado mais recentemente aparece primeiro na lista. Selecione o snapshot a ser exportado.

      Argumentos de entrada

      Os argumentos que o script do exportador usa para gerar dados de configuração como saída. A caixa de texto exibe os valores padrão para todos os argumentos. Atualize os valores conforme necessário.

      Formato de saída

      Formato no qual os dados de configuração serão gerados.

      Implantáveis adicionais

      Implantáveis para o qual gerar dados de configuração além do implantável primário que você especificou no campo Snapshot implantável e publicado para exportar.

      Somente os snapshots publicados mais recentes aparecem para esta configuração opcional.

    5. Selecione Avaliar.
      • O script do exportador é executado usando as configurações que você especificou.
      • O painel do Playground de teste exibe a página de saída Revisar.
      • Os dados de configuração que o exportador gera são exibidos na caixa Saída.
      • O sistema lista informações sobre a execução na guia Execuções.
    6. Analise os resultados.
      1. Para fazer mudanças, selecione Selecionar entradas, especifique novas configurações e selecione Avaliar.
      2. Repita a etapa anterior quantas vezes forem necessárias.
      Nota:
      Quando estiver satisfeito com o fato de o exportador gerar dados de configuração completos e seguir os padrões de formato de saída necessários, você poderá publicá-lo e ativá-lo.
    7. Publique o exportador selecionando Publicar na guia Construtor do exportador.
      Nota:
      Você deve definir um exportador como ativo para permitir que ele seja executado em um pipeline.