위젯 진단

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 3분
  • 위젯 사용자 지정 수준을 식별하고 포털 페이지에서 직접 위젯 코드를 확인하여 서비스 포털 페이지 문제를 해결합니다.

    포털 페이지가 예상대로 작동하지 않는 경우 위젯 코드의 버그 때문일 수 있습니다. 페이지를 진단하려면 페이지의 위젯을 진단해 보십시오.

    위젯 진단에는 다음이 포함됩니다.
    • 위젯 사용자 지정 수준 식별
    • 각 위젯에 사용되는 코드 확인

    커스터마이제이션 수준 식별

    사용자 지정 수준 은 위젯이 수정되거나 개발된 방법을 설명합니다. 위젯의 커스터마이제이션 수준을 식별하면 위젯 코드에서 가장 중요한 부분을 확인할 수 있습니다. 위젯 사용자 지정에는 네 가지 수준이 있습니다.
    사용자 지정 수준 설명
    기본 시스템 인스턴스 옵션이 설정된 위젯을 포함하여 수정 사항이 없는 기본 시스템 위젯입니다.
    복제됨 기본 시스템 위젯에서 클론한 위젯입니다.
    새로 만들기 생성한 위젯입니다.
    사용자 지정됨 다음 방법 중 하나로 구성한 기본 시스템 위젯입니다.
    • 위젯 코드를 직접 수정했습니다.
    • 수정된 위젯 옵션 스키마
    • 위젯 의존성, ng-템플릿 또는 Angular 공급자를 수정했습니다.

    포털 페이지에서 위젯의 커스터마이제이션 수준을 식별하려면 위젯 컨텍스트 메뉴를 열고 위젯 커스터마이제이션 표시를 선택합니다. 위젯은 다음과 같이 색으로 구분됩니다.

    커스터마이제이션 수준 식별
    • 녹색 – 기본 시스템 위젯
    • 노란색 – 복제된 위젯
    • 파란색 – 새 위젯
    • 빨간색 – 사용자 지정 위젯

    위젯 코드 확인

    포털 페이지에서 위젯의 커스터마이제이션 수준을 식별한 후 각 위젯의 코드를 확인합니다.

    포털 페이지에서 위젯 코드를 보려면 위젯에서 정보 아이콘( 정보 아이콘)을 클릭합니다.

    위젯 진단 창

    위젯 진단 창에서 여러 가지 방법으로 위젯 코드를 확인할 수 있습니다.
    • 포털 페이지에서 위젯 기록 보기

      포털 페이지에서 다른 곳으로 이동하지 않고 위젯 기록에서 잠재적으로 문제가 있는 코드를 보고 식별합니다.

    • 관련 기록 보기

      위젯에 사용 중인 위젯 종속성, Angular 제공자, ng-templates에서 잠재적으로 문제가 있는 코드를 보고 식별합니다.

    • 관련 기록과 변경 비교

      Angular 제공자나 ng-template을 이전 버전과 비교하여 최신 코드 변경으로 인해 포털 페이지에서 문제가 생기는지 확인합니다.

    • 변경 내용을 사용자 지정 위젯과 비교

      사용자 지정된 위젯의 최신 업데이트를 이전 버전과 비교하여 최근 변경 사항으로 인해 포털 페이지에서 문제가 생기는지 확인합니다.

    • 사용자 지정된 위젯을 기본 시스템과 비교

      사용자 지정된 위젯을 되돌리고 포털 페이지의 문제를 해결할 수 있도록 기본 시스템 위젯의 사용자 지정을 식별합니다.

    위젯 진단을 위한 권장 사항

    네 가지 사용자 지정 수준 중에서 우선순위가 가장 높은 문제는 사용자 지정 위젯입니다. 이러한 위젯은 시스템 업그레이드에서 지원되지 않습니다. 업그레이드 중에 페이지 문제가 발생하는 경우 포털 페이지에 사용자 지정된 위젯이 있기 때문일 수 있습니다.

    사용자 지정 위젯으로 인해 발생할 수 있는 페이지 문제를 해결하려면 위젯 코드에서 사용자 지정된 부분을 식별합니다. 그런 다음 코드를 원래 구성으로 되돌립니다. 이러한 코드 차이점을 식별하는 방법에 대한 자세한 내용은 을 참조하십시오 사용자 지정된 위젯을 기본 시스템과 비교.

    팁:
    사용자 지정 위젯이 현재 페이지 문제를 일으키지 않더라도 나중에 업그레이드 중에 발생하는 문제를 방지하기 위해 원래 위젯으로 되돌릴 수 있습니다.

    사용자 지정 위젯을 되돌린 후에도 페이지 문제가 계속 발생하면 다음에 새 위젯과 복제된 위젯을 확인하십시오.

    새 위젯을 사용하면 가장 최근의 코드 변경 내용으로 인해 포털 페이지에 문제가 발생할 수 있습니다. 코드를 디버그할 수 있도록 가장 최근의 변경 내용을 식별하려면 의 단계를 관련 기록과 변경 비교수행합니다.

    시스템 업그레이드 전에 위젯을 복제한 경우 복제된 위젯이 기본 시스템 위젯과 동일한 업데이트된 코드를 받지 못했을 수 있습니다. 이 경우 위젯을 다시 복제하고 복제본에 사용자 지정 항목을 추가하는 것이 좋습니다.

    기본 시스템 위젯은 페이지 문제를 일으킬 가능성이 가장 적습니다. 다른 위젯을 이미 확인했는데도 페이지 문제가 계속 발생하는 경우 페이지에서 기본 시스템 위젯을 제거하고 위젯 옵션을 설정하지 않고 다시 추가하십시오. 대신 기본 시스템 위젯을 다른 페이지에 추가해 볼 수도 있습니다.

    제한

    포털 페이지에서 위젯 진단을 사용할 때 알려진 몇 가지 제한 사항이 있습니다.
    • 위젯 코드를 보고 비교할 수는 있지만 코드를 직접 수정하거나 되돌릴 수는 없습니다. 포털에서 벗어나 코드를 변경합니다.
    • 위젯 진단을 사용하는 동안 다른 포털 페이지로 이동하면 시스템에서 도구를 비활성화합니다.
    • 이 도구는 색상을 사용하여 위젯을 분류하기 때문에 시각 장애가 있는 사용자는 접근하지 못할 수 있습니다.
    • 포털 페이지에 나열된 위젯 의존성은 첫 번째 수준의 의존성만 반영합니다. 첫 번째 수준보다 깊게 중첩된 종속성은 포함되지 않습니다. 위젯의 추가 문제를 해결하려면 위젯 기록의 중첩된 종속성을 확인합니다.
    • 위젯 의존성을 삭제한 후에는 시스템에서 위젯 의존성을 추적할 수 있는 방법이 없습니다.