Migrar o histórico do conjunto de atualizações concluído para o controle de código-fonte

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura
  • Ao vincular ao controle de código-fonte, este recurso permite que os desenvolvedores de aplicações tenham a opção de migrar as informações em conjuntos de atualizações concluídos para o histórico do controle de código-fonte.

    Antes de migrar

    Verifique se você atendeu a estes critérios antes de tentar migrar seus conjuntos para atualização:
    Quando você vincula uma aplicação ao controle de código-fonte, os conjuntos para atualização 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 para atualização concluídos, você será solicitado a fazer uma escolha na caixa de diálogo abaixo.
    • Se você selecionar "Sim, manter o 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 código-fonte.
    • Se você selecionar "Não, não manter o histórico do conjunto de atualizações como confirmações", eles não serão preservados como confirmações.
    Independentemente da opção selecionada, se você selecionar Continuar, a operação de Vincular ao controle de código-fonte será iniciada e todos os conjuntos para atualização concluídos e todos os registros de atualização do cliente serão excluídos. Se você precisar concluir quaisquer conjuntos para atualização adicionais ou optar por não continuar, selecione Cancelar. Caixa de diálogo solicitando suas escolhas para selecionar seu histórico de 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 pelo carimbo de data/hora sys_recorded_at. Para aplicações globais: todos os registros sys_update_xml que pertencem à aplicação e fazem parte de um conjunto de atualizações global concluído são capturados como confirmações históricas.

    Quando a operação Vincular ao controle de código-fonte estiver concluída, a confirmação mais recente será o estado atual da aplicação na íntegra. Você pode exibir confirmações históricas no 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 solicitado de atualizações.

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

    A pastaauthor_elective_update não é criada até a confirmação inicial. Isso significa que, na confirmação inicial, você pode ver arquivos como arquivos sys_choice sendo renomeados e movidos da pasta de atualização para a pasta de autor_eletiva_atualização. Todos os arquivos excluídos dos conjuntos de atualizações em confirmações históricas são excluídos e não movidos para a pastaauthor_elective_update como seriam para as confirmações reais. Durante a confirmação inicial, as cargas DELETE também são criadas para todos os registros SYS_update_xml DELETE 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 a seção Personalizaçãoabaixo)
    }
    {

    Informações do conjunto de atualizações em lote (consulte a seção Conjuntos para atualização em lote abaixo) }

    Conjuntos para atualização 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 do 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 outros campos a serem incluídos na mensagem de confirmação adicionando uma propriedade glide.source_control.historial_commit_fields. 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 campo inválidos ou com erros ortográficos são ignorados. Esta propriedade será usada para todas as aplicações que estão vinculadas ao controle de código-fonte da instância se o confirmador optar por reter 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