Legado - Migrar histórico de conjunto de atualizações concluído para o controle de origem

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • Ao vincular ao controle de origem, este recurso permite que os desenvolvedores de aplicações escolham migrar as informações em conjuntos de atualizações concluídos para o histórico do controle de origem.

    Importante:
    Começando com Xanaduversão, o. legadoversão de ServiceNow Studioestá sendo preparado para descontinuação futura. Ele ficará oculto e não será mais ativado em novas instâncias, mas continuará sendo compatível. Para obter detalhes sobre o processo de descontinuação, consulte Processo de descontinuação [KB0867184] artigo na Base de conhecimento do Now Support.

    Tente criar e editar apps na versão atual de ServiceNow Studioem vez disso. Para obter mais informações, consulte ServiceNow Studio.

    Antes de migrar

    Certifique-se de ter atendido a estes critérios antes de tentar migrar seus conjuntos de atualizações:
    Quando você vincula uma aplicação ao Controle de origem, os conjuntos de atualizações e os registros de atualização do cliente são excluídos. Depois de vincular ao Controle de código-fonte, se a aplicação tiver conjuntos de atualizações concluídos, você será solicitado a fazer uma escolha na caixa de diálogo abaixo.
    • Se você selecionar "Sim, manter histórico do conjunto de atualizações como confirmações", o histórico do conjunto de atualizações será preservado como confirmações do controle de origem.
    • Se você selecionar "Não, não reter o histórico do conjunto de atualizações como confirmações", eles não serão preservados como confirmações.
    Se você selecionar, independentemente da opção Continuar . Link para o controle de origem A operação é iniciada e todos os conjuntos de atualizações concluídos e todos os registros de atualização do cliente são excluídos. Se você precisar concluir conjuntos de atualizações adicionais ou optar por não continuar, selecione Cancelar . Caixa de diálogo solicitando suas opções para selecionar o histórico do conjunto de atualizações

    Para cada conjunto de atualizações concluído com atualizações para a aplicação que você está vinculando ao Controle de código-fonte, as confirmações são geradas automaticamente pelo sistema com base nos registros sys_update_xml nos conjuntos de atualizações. As confirmações são ordenadas por sys_recorded_at carimbo de data/hora. Para aplicações globais: Qualquer sys_update_xml Os registros que pertencem à aplicação e fazem parte de um conjunto de atualizações globais concluído são capturados como confirmações históricas.

    Quando a operação Vincular para controle de código-fonte estiver concluída, a confirmação mais recente será o estado atual da sua aplicação em sua totalidade. Você pode exibir confirmações históricas em seu repositório Git ou clicando na opção de menu Controle de código-fonte e selecionando Exibir histórico . As atualizações são separadas em várias confirmações:
    • Se houver atualizações para um arquivo que estão fora de ordem entre diferentes conjuntos de atualizações.
    • Se um conjunto de atualizações contiver vários registros de atualização para um único arquivo.

    As confirmações de um conjunto de atualizações são divididas em várias confirmações ([Confirmação histórica 1], [Confirmação histórica 2]...) para representar cada atualização. Isso é feito para que cada arquivo tenha um histórico ordenado de atualizações.

    Aviso:
    Qualquer confirmação prefixada por [Confirmação histórica] é gerada exclusivamente para exibir seu histórico. Não tente fazer check-out desses commits no processo de desenvolvimento, pois eles não representam necessariamente um snapshot estável da aplicação.

    . author_elective_update a pasta não é criada até a confirmação inicial. Isso significa que na confirmação inicial, você pode ver arquivos como sys_choice arquivos sendo renomeados e movidos da pasta de atualização para author_elective_update pasta. Todos os arquivos excluídos de conjuntos de atualizações em confirmações históricas serão excluídos e não movidos para author_elective_update como seriam para confirmações reais. Durante a confirmação inicial, as cargas de EXCLUSÃO também são criadas para todos os registros sys_update_xml de EXCLUSÃO que foram excluídos como parte dos conjuntos de atualizações concluídos.

    Exemplo de mensagem de confirmação:
    [Historical Commit 1] <Name of update set that this commit belongs to>
    Description: <Description of update set that this commit belongs to>
    Update Set was completed on / installed on <date>
    Update Set was completed by <sys_user user_name > <sys_user email>
    {
    Valores adicionais do registro sys_update_set (consulte Personalização abaixo)
    }
    {

    Informações do conjunto de atualizações em lote: Consulte Conjuntos de atualizações em lote abaixo.

    Conjuntos de atualizações em lote

    Se um conjunto de atualizações fizer parte de um conjunto de atualizações em lote, essas informações serão anexadas à mensagem de confirmação no seguinte formato, com o número mais alto sendo a Base em lote:

    {
    "1": {
    "parent": "<name of parent update set>",
    "description": "<description of parent update set>"
    },
    "2": {
    "parent": " <name of parent 1’s parent update set> ",
    "description": " <description of parent 1’s parent update set> "
    }
    }
    

    Personalização

    Você pode adicionar campos adicionais para incluir na mensagem de confirmação adicionando um glide.source_control.historical_commit_fields propriedade. O valor é uma lista separada por vírgulas de campos que o usuário deseja incluir dos campos xml sys_update_set. Espaços e nomes de campos inválidos ou com erros ortográficos são ignorados. Esta propriedade é usada para todas as aplicações vinculadas ao Controle de código-fonte da instância se o committer optar por manter o histórico do conjunto de atualizações.

    Nota:
    Se o valor de um campo fizer referência a outra tabela ou sys_id, somente o valor do campo será adicionado. Por exemplo: Sys_id para um usuário em vez do nome do usuário.
    Figura 1. Exemplo de XML
    XML de amostra
    Figura 2. Valor da propriedade
    Valor da propriedade
    Figura 3. Resultado na mensagem de confirmação
    O resultado exibido na mensagem de confirmação