모바일 마이그레이션 스크립트 결과의 일반적인 문제 해결

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분
  • 모바일 마이그레이션 스크립트 실행 후 일반적인 문제에 대한 해결책을 찾아보십시오.

    로그 오류 메시지

    모바일 마이그레이션 스크립트에서 오류가 발생하면 로그 [syslog] 테이블에 항목을 추가합니다. 다음으로 이동하여 이러한 로그를 검토할 수 있습니다. 시스템 로그 > 시스템 로그 > 모두. 모바일 마이그레이션 스크립트가 로그에 추가할 수 있는 오류는 다음과 같습니다.

    표 1. 오류 메시지
    오류 메시지 해결
    잘못된 인스턴스 범위가 제공됨 이 메시지가 표시되면 마이그레이션 스크립트가 중단된 것입니다. 마이그레이션 스크립트를 다시 실행하여 마이그레이션을 완료합니다. 범위를 다시 열고 스튜디오 선택하여 마이그레이션 스크립트를 다시 실행할 수 있습니다.
    마이그레이션 전에 먼저 com.glide.mobile-employee를 활성화하십시오. ServiceNow 마이그레이션 스크립트를 실행하려면 NowMobile App Screens and Applet Launcher [com.glide.mobile-employee] 플러그인이 활성 상태여야 합니다. 이 플러그인이 활성 상태인지 확인하십시오. 이 메시지가 표시되면 마이그레이션 스크립트가 중단된 것입니다. 마이그레이션 스크립트를 다시 실행하여 마이그레이션을 완료합니다.
    사용자 지정된 기록에 대한 마이그레이션 작업을 수행할 수 없습니다. 이 오류를 발생시키는 기록은 이 메시지 바로 뒤에 나타납니다. 이 기록에 대한 커스터마이제이션으로 인해 마이그레이션 스크립트에서 이 파일을 변경할 수 없습니다. 마이그레이션 스크립트는 이 파일을 건너뛰고 계속 실행됩니다. 명명된 파일은 에서 액세스할 수 없습니다.스튜디오

    충돌

    충돌은 업그레이드 또는 이후 버전으로 New York 업그레이드하기 전에 사용자 지정한 기본 시스템 애플리케이션에서 발생할 수 있습니다. 마이그레이션 스크립트가 충돌을 탐지하면 스크립트 실행이 완료된 후 충돌을 검토하라는 메시지를 표시합니다.

    모바일 마이그레이션 충돌 프롬프트.

    충돌 보기 단추를 클릭하여 필터링된 업그레이드 상세 정보 [sys_upgrade_history_log] 기록 목록을 봅니다. 이 목록에는 업그레이드 프로세스가 건너뛴 현재 범위 내의 기록이 표시됩니다. 상충을 해결하려면 이 목록에서 기록을 클릭하여 기록을 연 다음 상충 해결 단추를 클릭하십시오.

    상충 해결 양식에는 사용자 지정된 버전과 함께 기록의 기본 시스템 버전이 표시됩니다. 버전마다 다른 필드는 진한 배경으로 강조 표시됩니다.

    상충 해결 양식.
    화살표 버튼( 화살표 버튼)을 사용하여 값을 한 버전에서 다른 버전으로 이동합니다. 변경한 후 병합 저장 버튼을 클릭하여 변경 내용을 저장합니다. 기본 시스템으로 되돌리기 버튼을 클릭하여 사용자 지정 항목을 취소하고 수정되지 않은 버전의 기록을 사용할 수도 있습니다.

    일반적인 충돌 문제는 마스터 상세 정보 [sys_sg_master_detail_screen] 기록입니다. 릴리스부터 New York 마스터 상세 정보 기록은 더 이상 모바일 스키마의 일부가 아닙니다. 이러한 기록은 새 목록 [sys_sg_list_screen] 및 양식 [sys_sg_form_screen] 화면 기록으로 대체됩니다. 일반적으로 업그레이드 프로세스의 일부로 삭제되지만 사용자 지정된 경우 스크립트에서 자동으로 삭제하지 않습니다. 예를 들어 기본 시스템 애플리케이션의 이름을 변경한 경우 이러한 종류의 충돌이 발생할 수 있습니다.

    이 문제를 해결하려면 모바일 스튜디오를 확인하여 애플릿을 계속 사용할 수 있고 예상대로 작동하는지 확인합니다. 애플릿을 사용할 수 있는지 확인한 후에는 기본 상세 정보 기록을 삭제할 수 있습니다.

    일반적인 마이그레이션 문제

    애플릿이 없습니다.
    마이그레이션 후에는 애플릿이 탐색 모음의 애플리케이션 탭에 표시됩니다. 애플릿이 나타나지 않으면 이러한 애플릿을 수동으로 마이그레이션할 수 있습니다.
    1. 에서 스튜디오열기 모바일 스튜디오 > 애플리케이션 메뉴 애플리케이션 탐색기에서 애플릿이 없는 앱을 선택합니다.
    2. 탐색 탭 관련 목록에서 애플리케이션 탐색 탭을 클릭합니다.
    3. 애플리케이션 탭과 연결된 애플릿 시작 관리자를 확인합니다.
    4. 에서 스튜디오열기 모바일 스튜디오 > 애플릿 시작 관리자, 마지막 단계에서 설명한 애플릿 시작 관리자를 엽니다.
    5. 애플릿 시작 관리자 양식에서 마이그레이션 전에 누락된 애플릿이 있던 폴더와 이름이 같은 UI 섹션을 선택합니다.
    6. 모든 애플릿 목록에서 누락된 애플릿을 찾아 선택한 애플릿 목록으로 이동합니다.
    7. 저장을 클릭하십시오.
    애플릿에 관련 목록이 없습니다.
    이 문제는 관련 목록 매핑 [sys_sg_related_list_map] 테이블에 대한 오래된 참조의 결과일 수 있습니다. 관련 목록의 대상 화면 을 다시 연결하여 문제를 해결할 수 있습니다.
    1. 스튜디오에서 모바일 스튜디오 > 애플릿을 클릭하고 누락된 세그먼트가 있는 애플릿을 선택합니다.
    2. 양식 화면 탭을 클릭합니다.
    3. 문을 클릭합니다.
    4. 관련 목록 버튼을 클릭합니다.
    5. 목록에서 대상 화면 값이 비어 있는 항목을 확인합니다.
    6. 목록 항목을 클릭하고 대상 화면 필드에서 값을 선택합니다.
    사용자에게 또는 애플릿에 현장 서비스 관리ITSM 입력 매개변수를 입력하라는 메시지가 표시되지 않습니다.
    일반적으로 매개변수형 애플릿은 사용자에게 값에 대한 프롬프트를 표시합니다. 마이그레이션 후 이 메시지가 더 이상 표시되지 않으면 다음 단계를 사용하여 문제를 해결합니다.
    1. 인스턴스의 필터 탐색기에 sys_sg_ui_parameter.list 를 입력하여 UI 매개변수 [sys_sg_ui_parameter] 목록을 엽니다.
    2. 사용자에 대한 프롬프트를 생성하지 않는 매개변수를 찾습니다.
    3. 화면 필드의 값을 확인합니다. 이 필드가 비어 있는 것으로 나타나면 마스터-상세 정보 화면 [sys_sg_master_detail_screen] 기록을 가리키고 있을 수 있습니다.
    4. 이 매개변수에서 사용하는 애플릿 [sys_sg_screen] 기록을 선택하여 필드를 업데이트합니다.
    사용자 지정 현장 서비스 관리 또는 ITSM 애플릿에 대한 결과가 잘못되었습니다.
    기본 시스템에 고객 매개변수를 추가한 경우 이 문제가 발생할 수 있습니다.
    1. 인스턴스의 필터 탐색기에 sys_sg_screen_param_map.list 를 입력하여 화면 매개변수 매핑 [sys_sg_screen_param_map] 목록을 엽니다.
    2. 데이터 항목에 추가한 항목 매개변수와 일치하는 항목 매개변수 필드가 있는 기록을 찾습니다.
    3. 화면 필드의 값을 확인합니다. 이 필드가 비어 있는 경우 사용하지 않은 마스터-상세 정보 화면 [sys_sg_master_detail_screen] 기록을 가리키고 있을 수 있습니다.
    4. 이 매개변수에서 사용하는 애플릿 [sys_sg_screen] 기록을 선택하여 필드를 업데이트합니다.