Legacy - 완료된 업데이트 세트 이력을 소스 통제로 마이그레이션

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분

    • 소스 통제에 연결할 때 이 기능을 사용하면 애플리케이션 개발자가 완료된 업데이트 세트의 정보를 소스 통제 기록으로 마이그레이션할 수 있습니다.

    중요사항:
    릴리스부터 Xanadu 이 버전 ServiceNow 스튜디오 은 Legacy 향후 사용 중단 예정입니다. 이 항목은 숨겨지고 새 인스턴스에서 더 이상 활성화되지 않지만 지원은 계속됩니다. 사용 중단 프로세스에 대한 자세한 내용은 Now Support 지식베이스의 사용 중단 프로세스 [KB0867184] 문서를 참조하십시오.

    대신 현재 버전의 ServiceNow 스튜디오 앱에서 앱을 빌드하고 편집해 보십시오. 자세한 내용은 ServiceNow 스튜디오 문서를 참조하십시오.

    마이그레이션하기 전

    업데이트 세트 마이그레이션을 시도하기 전에 다음 기준을 충족했는지 확인하십시오.
    애플리케이션을 소스 통제에 연결하면 업데이트 세트와 고객 업데이트 기록이 삭제됩니다. 소스 통제에 연결한 후 애플리케이션에 완료된 업데이트 세트가 있는지 아래 대화 상자에서 선택하라는 메시지가 표시됩니다.
    • "예, 업데이트 세트 이력을 커밋으로 유지합니다"를 선택하면 업데이트 세트 이력이 소스 통제 커밋으로 보존됩니다.
    • "아니요, 업데이트 세트 이력을 커밋으로 유지하지 마십시오"를 선택하면 커밋으로 보존되지 않습니다.
    어떤 옵션을 선택하든 계속을 선택하면 소스 통제에 연결 작업이 시작되고 완료된 모든 업데이트 세트와 모든 고객 업데이트 기록이 삭제됩니다. 추가 업데이트 세트를 완료해야 하거나 계속하지 않으려면 취소를 선택합니다. 업데이트 세트 이력 선택을 위한 선택 항목을 요청하는 대화 상자

    소스 통제에 연결하는 애플리케이션에 대한 업데이트가 포함된 모든 완료된 업데이트 세트에 대해 업데이트 세트의 sys_update_xml 기록에 따라 시스템에서 커밋이 자동으로 생성됩니다. 커밋은 sys_recorded_at 타임스탬프별로 정렬됩니다. 전역 애플리케이션의 경우: 애플리케이션에 속하고 완료된 전역 업데이트 세트의 일부인 모든 sys_update_xml 기록은 이력 커밋으로 캡처됩니다.

    소스 통제에 연결 작업이 완료되면 가장 최근 커밋은 애플리케이션 전체의 현재 상태입니다. Git 리포지토리에서 또는 소스 통제 메뉴 옵션을 클릭하고 기록 보기를 선택하여 과거 커밋을 볼 수 있습니다. 업데이트는 여러 커밋으로 구분됩니다.
    • 서로 다른 업데이트 세트 간에 순서가 잘못된 파일에 대한 업데이트가 있는 경우
    • 업데이트 세트에 단일 파일에 대한 여러 업데이트 기록이 포함되어 있는 경우.

    업데이트 세트에 대한 커밋은 각 업데이트를 나타내기 위해 여러 커밋([이력 커밋 1], [이력 커밋 2]...)으로 분할됩니다. 이렇게 하면 각 파일에 순서가 지정된 업데이트 기록이 있습니다.

    경고:
    [Historical Commit] 프리픽스가 붙은 모든 커밋은 기록을 표시하기 위해서만 생성됩니다. 이러한 커밋은 반드시 애플리케이션의 안정적인 스냅샷을 나타내지는 않으므로 개발 프로세스에서 체크 아웃을 시도하지 마십시오.

    author_elective_update 폴더는 초기 커밋 전까지 생성되지 않습니다. 즉, 초기 커밋에서 sys_choice 파일과 같은 파일의 이름이 바뀌고 업데이트 폴더에서 author_elective_update 폴더로 이동되는 것을 볼 수 있습니다. 이력 커밋의 업데이트 세트에서 삭제된 파일은 모두 삭제되며, 실제 커밋에서와 같이 author_elective_update 폴더로 이동되지 않습니다. 초기 커밋 중에 완료된 업데이트 세트의 일부로 삭제된 모든 DELETE sys_update_xml 기록에 대해서도 DELETE 페이로드가 생성됩니다.

    예제 커밋 메시지:
    [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>
{
    sys_update_set 기록의 추가 값(아래 커스터마이제이션 섹션 참조)
    }
{

    일괄 업데이트 세트 정보: 아래의 일괄 업데이트 세트 섹션을 참조하십시오.

    배치 업데이트 세트

    업데이트 세트가 배치 업데이트 세트의 일부인 경우 해당 정보는 다음 형식으로 커밋 메시지에 추가되며 가장 높은 숫자는 배치 기본입니다.

    {
"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> "
}
}

    커스터마이제이션

    glide.source_control.historical_commit_fields 속성을 추가하여 커밋 메시지에 포함할 필드를 추가할 수 있습니다. 값은 사용자가 포함하려는 필드의 쉼표로 구분된 목록 sys_update_set XML 필드입니다. 공백이나 유효하지 않거나 맞춤법이 잘못된 필드 이름은 무시됩니다. 이 속성은 커밋자가 업데이트 세트 기록을 유지하기로 선택한 경우 인스턴스에서 소스 통제에 연결된 모든 애플리케이션에 사용됩니다.

    주:
    필드 값이 다른 테이블이나 sys_id 참조하는 경우에는 필드 값만 추가됩니다. 예: 사용자 이름 대신 사용자에 대한 sys_id.
    그림 1. XML 예
    샘플 XML
    그림 2. 속성의 값
    속성의 값
    그림 3. 커밋 메시지의 결과
    커밋 메시지에 표시되는 결과