솔루션 검사기에 대한 일반적인 문제 및 해결 방법

이 문서에서는 솔루션 검사기를 사용하는 동안 발생할 수 있는 몇 가지 일반적인 문제를 나열합니다. 해당되는 경우 해결 방법이 제공됩니다.

솔루션 검사기를 사용하여 분석 또는 결과 다운로드를 실행할 수 없음

분석 실행 또는 결과 다운로드를 위해 솔루션 검사기 요청을 제출한 직후 작업이 완료되지 않고 다음과 같은 오류 메시지가 표시됩니다.

"[솔루션 이름] 솔루션에 대한 검사를 실행할 수 없습니다. 다시 실행해 보십시오."

가능할 때마다 솔루션 검사기는 잠재적 원인 및 해결 단계에 대한 세부 정보 링크가 있는 특정 오류 메시지를 반환하려고 시도합니다. 자세한 내용은 '자세히 알아보기' 를 선택하십시오.

분석을 백그라운드에서 처리하는 동안 발생하는 오류는 '완료할 수 없습니다' 상태로 실패하고 Power Apps 오류 메시지를 반환하고 요청자에게 전자 메일 알림을 보냅니다.

포털 알림을 선택하면 추가 문제 해결을 위해 일반적인 문제에 대한 이 페이지로 연결됩니다. 제공된 공통 문제점 중 하나가 문제를 해결하지 못하면 참조 번호도 반환됩니다. 추가 조사를 위해 Microsoft 지원부에 이 참조 번호를 제공하십시오.

솔루션 검사기가 기본 솔루션을 확인하지 못함

솔루션 검사기는 분석을 위해 Microsoft Power Platform 환경에서 솔루션을 내보냅니다. 기본 솔루션 내보내기가 지원되지 않으며 확인이 완료되지 않을 수 있습니다. 추가 정보: 솔루션 검사기가 큰 솔루션을 내 보내지 못함.

Power Apps 검사기의 지원되지 않는 버전으로 인해 솔루션 검사기가 실패함

솔루션 검사기는 Power Apps 검사기 앱에서 활성화되는 기능입니다. 1.0.0.47 이전 버전의 Power Apps 검사기 앱 버전이 설치된 경우 솔루션 검사기 실행이 성공적으로 완료되지 않을 수 있습니다. Power Platform 관리 센터에서 Power Apps 검사기 버전을 업그레이드해야 합니다.

그러나 Power Apps 검사기 버전이 설치된 1.0.0.45 버전보다 이전 버전인 경우에는 솔루션을 삭제하고 다시 설치하는 것이 좋습니다. 최근의 스키마 변경으로 인해 1.0.0.45 이전 버전의 Power Apps 검사기 업그레이드가 실패할 수 있습니다.

솔루션 검사기의 과거 결과를 유지하려면 이전 실행의 결과를 내보내거나 데이터 Excel로 데이터 내보내기를 사용하여 모든 솔루션 검사기 데이터를 내보내 다음 테이블에서 데이터를 내보냅니다.

• 분석 구성 요소
• 분석 작업
• 분석 결과
• 분석 결과 세부 정보

Power Apps 검사기를 제거하는 방법

Power Apps 검사기 솔루션을 제거하려면:

1. 시스템 관리자 또는 시스템 사용자 지정자의 경우 https://make.powerapps.com/environments로 이동하여 Power Apps 포털을 엽니다.
2. 솔루션을 선택합니다.
3. Power Apps 검사기를 선택한 다음 솔루션 도구 모음에서 삭제를 선택합니다.

Power Apps 검사기를 설치하는 방법

Power Apps 검사기를 환경에 다시 설치하려면:

1. 시스템 관리자 또는 시스템 사용자 지정자의 경우 https://make.powerapps.com/environments로 이동하여 Power Apps 포털을 엽니다.
2. 솔루션을 선택합니다.
3. 솔루션 도구 모음에서 솔루션 검사기를 선택한 다음 설치를 선택합니다.

솔루션 검사기가 관리 모드에서 환경에 액세스할 수 없음

관리 모드가 된 환경은 시스템 관리자 및 시스템 사용자 지정자 역할을 가진 사용자만 액세스할 수 있도록 제한됩니다. Power Apps 검사기 애플리케이션 ID에는 이러한 역할이 기본적으로 할당되어 있지 않으므로 이 모드로 작동하는 조직에 액세스할 수 없습니다.

이 조직에서 솔루션 검사기를 사용하려면 관리 모드를 사용하지 않아야 합니다.

관리 모드를 비활성화하는 방법

조직 인스턴스에 대한 관리 모드를 비활성화하려면:

1. Power Platform 관리 센터에 로그인합니다.

2. 솔루션 검사기를 실행하는 데 문제가 있는 환경을 열고 편집을 선택합니다.

3. 관리 모드를 사용하지 않도록 설정한 다음 저장을 선택합니다.

   

4. 솔루션 검사기를 다시 실행합니다.

보안 역할이 누락되어 솔루션 검사기가 실패함

솔루션 검사기의 애플리케이션 사용자는 Dataverse 조직과 통신하는 데 필요한 권한을 제공하기 위해 할당된 다음 보안 역할이 필요합니다. 이러한 역할 중 하나라도 'Power Apps 검사기 애플리케이션' 사용자에 할당되지 않은 경우 분석 실행, 결과 다운로드 및 실행 취소 시도가 실패합니다. 이는 예기치 않은 사용자로부터 보안 역할을 제거하는 자동화 기능을 고객이 가지고 있는 경우에 가장 자주 발생합니다. 다음 보안 역할에는 최소한의 필요한 사용 권한이 포함되어 있습니다.

• 사용자 지정 항목(솔루션 검사기) 가져오기
• 서비스 작성자
• 솔루션 검사기

누락된 보안 역할을 할당하는 방법

누락된 보안 역할을 Power Apps 검사기 애플리케이션 사용자에게 할당하려면:

1. Power Platform 관리 센터에서 환경으로 이동한 다음 사용자 > 앱 사용자 목록으로 이동합니다.
2. 사용자 목록에서 'Power Apps 검사기 애플리케이션' 사용자를 선택합니다.
3. 명령 모음에서 보안 역할 편집을 선택합니다.
4. 위에 나열된 역할에 대한 확인란을 선택한 다음 저장을 선택합니다.
5. 솔루션 검사기를 다시 실행합니다.

제한된 액세스 모드로 인해 솔루션 검사기가 실패합니다.

솔루션 검사기에 대한 애플리케이션 사용자는 Dataverse 조직과 통신하기 위해 '비대화형' 또는 '읽기-쓰기' 액세스 모드가 필요합니다. 액세스 모드가 '관리' 와 같은 다른 값으로 변경되면 분석 실행, 결과 다운로드 및 취소 실행 시도가 실패합니다.

이 문제를 해결하려면 'Power Apps 검사기' 애플리케이션 사용자에게 '비대화형' 액세스 모드를 제공합니다.

사용자 액세스 모드를 업데이트하는 방법

Power Apps 검사기 사용자의 액세스 모드를 업데이트하려면:

1. Dataverse 조직을 열고 설정 > 보안 > 사용자로 이동합니다.
2. 사용자 목록에서 'Power Apps 검사기' 사용자를 선택하고 두 번 클릭하여 사용자 양식을 엽니다.
3. 양식의 '관리' > '클라이언트 액세스 라이선스(CAL) 정보' 섹션으로 스크롤합니다.
4. 액세스 모드 드롭다운 컨트롤에서 '비대화형' 을 선택합니다.

5. 사용자 양식을 저장하고 닫습니다.
6. 솔루션 검사기를 다시 실행합니다.

비활성화된 애플리케이션 사용자로 인해 솔루션 검사기가 실패함

분석할 솔루션이 포함된 Dataverse 조직의 Power Apps 검사기 애플리케이션 사용자를 활성화해야 합니다. 애플리케이션 사용자가 비활성화되면 동일한 조직에서 솔루션 분석 요청이 실패합니다. 이 오류 메시지가 표시되면 먼저 Power Apps 검사기 애플리케이션 사용자는 실제로 비활성화되어 있는지 확인합니다. 그런 다음 아래 제공된 완화 단계를 따르십시오.

Power Apps 검사기 애플리케이션 사용자를 활성화하는 방법

1. Power Platform 관리 센터에서 환경을 선택하고 설정 > 사용자의 + 권한 > 사용자로 이동합니다.
2. 애플리케이션 사용자 보기에서 Power Apps 검사기 애플리케이션 사용자 옆의 확인란을 선택합니다.
3. 작업 도구 모음에서 사용을 선택합니다.

4. 사용자 활성화 확인 메시지에서 활성화를 선택합니다.
5. 다른 방법은 애플리케이션 사용자 양식을 열고 양식 바닥글에서 사용 상태를 선택하는 것입니다. 변경 내용을 저장합니다.

솔루션 검사기가 30분 이상 실행 상태로 유지됨

분석된 솔루션에 .NET Standard 2.0을 사용하여 개발된 플러그인 구성 요소가 포함된 경우 솔루션 검사기가 무기한 실행 상태로 유지될 수 있습니다. .NET Standard 2.0을 사용하는 플러그인은 현재 솔루션 검사기에서 지원되지 않으므로 분석에서 제외해야 합니다. 대상 솔루션에서 제거하거나 Power Apps 검사기 PowerShell 모듈에서 'ExcludedFileNamePattern' 매개 변수를 사용하여 플러그인 구성 요소를 제외합니다.

솔루션 검사기가 실패하는 일반적인 플러그 인 조건

솔루션 검사기는 분석 요청을 수신하고 처리할 때 Dataverse 끝점을 호출하여 관련 작업 데이터를 검색/업데이트하고 선택한 솔루션을 내보냅니다. Dataverse와 솔루션 검사기 서비스의 각 상호 작용은 요청에 제출된 메시지에 등록된 하나 이상의 플러그 인 단계를 잠재적으로 트리거할 수 있습니다. 이러한 플러그 인은 메시지가 Dataverse에 의해 예상대로 처리되지 못하게 하는 조건을 도입할 수 있으며 솔루션 검사기가 요청된 분석 작업을 처리하는 기능을 방해할 수 있습니다. 솔루션 검사기 작업 결과를 다운로드하거나 진행중인 분석 작업을 취소할 때 비슷한 상황이 발생할 수 있습니다.

솔루션 검사기가 요청하는 일반적인 Dataverse 작업:

• 솔루션, systemuser 및 조직 테이블 데이터 검색
• 분석 작업, 분석 구성 요소 및 분석 결과 테이블 데이터 생성, 업데이트 및 검색
• 솔루션 내보내기

라이선스가 없는 사용자 환경에서 실행되도록 등록된 플러그인 단계

"라이선스가 없는 사용자" 예외로 인해 솔루션 검사기가 실패하는 경우, 현재 라이선스가 없는 특정 시스템 사용자의 컨텍스트에서 실행되도록 구성되어 트리거된 플러그 인 단계로 인해 종종 발생합니다. 솔루션 검사기가 트리거할 수 있는 모든 플러그 인 단계가 라이선스가 있는 사용자의 컨텍스트에서 실행되는지 확인하십시오.

중요

할당된 라이선스가 취소될 수 있는 특정 사용자가 아닌 호출 사용자의 컨텍스트에서 실행되도록 플러그 인 단계를 구성하는 것이 좋습니다.

플러그 인 단계가 Power Apps 검사기 애플리케이션 사용자에게 부여되지 않은 권한이 필요한 작업을 수행함

Dataverse가 누락된 권한에 따라 액세스를 거부하여 솔루션 검사기가 실패한 경우, 종종 현재 Power Apps 검사기 애플리케이션 사용자에게 부여되지 않은 권한이 필요한 작업을 수행하는 플러그 인 단계가 트리거되어 발생합니다. 솔루션 검사기가 호출한 작업에서 실행되지 않도록 플러그 인 단계를 다시 구성하거나 Power Apps 검사기 애플리케이션 사용자에게 사용자 지정 플러그 인 단계를 실행하는 데 필요한 권한을 부여합니다.

플러그 인 단계가 InvalidPluginExecutionException을 발생시켜 예기치 않게 실행이 중단됨

"ISV 코드로 인한 작업 중단" 또는 "ISV 코드로부터 예기치 않은 오류 발생" 오류로 인해 솔루션 검사기에서 장애가 발생할 수 있습니다. 이 경우 이는 플러그인 단계가 트리거되어 InvalidPluginExcecutionException 발생으로 인해 실행이 명시적으로 중단되었거나 플러그인 코드에서 오류가 적절하게 발견되지 않았음을 나타냅니다. 솔루션 검사기가 호출한 조작에서 실행되지 않도록 플러그 인 단계를 재구성하거나 솔루션 검사기가 제시한 조건에 따라 실행이 중단되지 않도록 플러그 인 구현을 조정하십시오.

솔루션 검사기가 호출하는 일반 작업에는 만들기 및 업데이트가 포함됩니다. 이러한 작업은 분석 작업, 분석 구성 요소 또는 분석 결과 테이블에서 발생할 수 있습니다.

Microsoft Entra ID의 비활성화된 자사 애플리케이션으로 인해 솔루션 검사기가 실패함

솔루션 검사기(PowerApps-Advisor)에서 사용되는 자사 엔터프라이즈 애플리케이션 ID는 Microsoft Entra ID에서 비활성화되어야 합니다. 비활성화하는 경우 요청하는 사용자를 대신하여 Dataverse 및 기타 필수 리소스 공급자에 대한 전달자 토큰을 요청할 때 인증할 수 없습니다.

아래 단계에 따라 애플리케이션 ID가 Microsoft Entra에서 비활성화되어 있지 않은지 확인하고 필요한 경우 애플리케이션을 활성화하십시오.

애플리케이션 활성화 상태를 확인 및/또는 수정하는 방법

PowerApps-Advisor 엔터프라이즈 애플리케이션 ID의 활성화 상태를 확인 및/또는 수정하려면

1. Microsoft Entra 포털에서 테넌트에 액세스합니다.
2. 엔터프라이즈 애플리케이션으로 이동합니다.
3. 모든 애플리케이션을 선택하고 'PowerApps-Advisor' 를 검색합니다.

4. 'PowerApps-Advisor' 를 선택하여 앱 세부 정보를 봅니다.
5. 속성을 선택합니다.
6. 사용자가 로그인할 수 있도록 설정 상태를 확인합니다. '아니요' 인 경우 애플리케이션이 비활성화된 것입니다.

7. 값을 '예' 로 전환할 라디오 컨트롤을 선택합니다. 이렇게 하면 애플리케이션을 사용할 수 있습니다.

8. 저장을 선택합니다. 애플리케이션이 이제 활성화됩니다. 변경 사항이 적용되려면 몇 분 정도 기다려야 할 수 있습니다.
9. 솔루션 검사기를 다시 실행합니다.

중요

엔터프라이즈 애플리케이션을 편집하려면 Microsoft Entra ID(Microsoft Entra ID)의 관리자 권한이 있어야 합니다.

솔루션 검사기가 초안 비즈니스 프로세스 흐름 구성 요소를 사용하여 솔루션을 내보낼 수 없음

솔루션에 이전에 활성화된 적이 없는 초안 상태의 비즈니스 프로세스 흐름 구성 요소가 포함되어 있으면 솔루션 검사기가 분석을 위해 솔루션을 내보내는 데 실패합니다. 이 오류는 솔루션 검사기에 고유하지 않으며 비즈니스 프로세스 흐름이 처음 활성화될 때까지 생성되지 않는 백업(사용자 지정) 테이블 엔터티 구성 요소에 대한 종속성이 있는 비즈니스 프로세스 흐름으로 인해 발생합니다. 이 문제는 솔루션 탐색기에서 비즈니스 프로세스 흐름을 활성화한 경우에도 발생할 수 있습니다.

문제 및 해결 단계에 대한 자세한 내용은 참조 자료 문서 #4337537: 잘못된 내보내기 - 비즈니스 프로세스 테이블 누락을 참조하세요.

솔루션 검사기가 모델 기반 앱 구성 요소를 사용하는 솔루션을 내보낼 수 없음

솔루션에 모델 기반 앱이 있는 경우 솔루션 검사기에서 분석을 위해 솔루션을 내보내지 못할 수 있습니다. 이 오류는 앱 공유에 대한 역할 기반 보안으로 인해 발생합니다. 만약 Power Apps 검사기 애플리케이션 사용자가 모델 기반 앱에 적절한 액세스 권한이 없는 경우, 이를 포함하는 모든 솔루션을 솔루션 검사기로 내보내지 못합니다.

이 문제를 해결하려면 환경 결정자 보안 역할을 Power Apps 검사기 애플리케이션 사용자에게 부여합니다.

솔루션 검사기가 패치된 솔루션을 내보낼 수 없음

솔루션에 패치가 적용된 경우 솔루션 검사기에서 분석을 위해 솔루션을 내보내지 못합니다. 솔루션에서 패치를 적용하면 원래 솔루션은 잠기게 되며 솔루션을 상위 솔루션으로 식별하는 종속 패치가 조직에 존재하는 경우 패치를 변경하거나 내보낼 수 없습니다.

이 문제를 해결하려면 솔루션에 관련된 모든 패치가 새로 만든 솔루션으로 롤백되도록 솔루션을 복제합니다. 이렇게 하면 솔루션의 잠금이 해제되고 시스템에서 솔루션을 내보낼 수 있습니다. 자세한 내용은 솔루션 복제를 참조하십시오.

솔루션 검사기가 빈 솔루션을 분석하지 않음

솔루션 검사기가 분석할 구성 요소가 없는 솔루션을 내보내면 추가 처리가 종료되고 실행 실패로 간주됩니다. 솔루션 검사기 분석을 위해 제출된 선택한 솔루션에 하나 이상의 구성 요소가 포함되어 있는지 확인하십시오.

솔루션 검사기가 대규모 솔루션을 내보낼 수 없습니다

환경에서 대규모 솔루션을 내보낼 수 없는 경우의 기본 시나리오에는 내보내기 요청에 대한 시간 초과 예외가 포함됩니다. 요청이 20분을 초과하는 경우 발생합니다. 기본 솔루션과 같은 대형 솔루션은 이 시간 프레임 내에 내보내지 못할 수 있으며 검사는 성공적으로 완료되지 않습니다. 내보내는 동안 솔루션 검사기에 시간 초과가 발생하는 경우 작업 처리에 실패하기 전에 세 번 재시도하므로 실패 알림이 표시되기 전에 1시간 이상 걸릴 수 있습니다.

해결 방법은 분석할 구성 요소가 적을수록 더 작은 솔루션을 만드는 것입니다. 솔루션의 큰 파일 크기가 여러 플러그 인 어셈블리 구성 요소 때문이라면 사용자 지정 어셈블리 개발을 최적화하기 위한 지침을 참조하십시오.

중요

가양성을 최소화하려면 종속 사용자 지정을 추가해야 합니다. 솔루션을 만들고 이러한 구성 요소를 추가하는 경우 다음을 포함합니다.

• 플러그 인을 추가할 때 플러그 인에 대한 SDK 메시지 처리 단계를 포함합니다.
• 테이블 양식을 추가할 때 양식 이벤트에 연결된 JavaScript 웹 리소스를 포함합니다.
• JavaScript 웹 리소스를 추가하는 경우 모든 종속 JavaScript 웹 리소스를 포함합니다.
• HTML 웹 리소스를 추가할 때 HTML 웹 리소스 내에 정의된 모든 종속 스크립트를 포함합니다.
• 사용자 지정 워크플로를 추가할 때 워크플로 내에서 사용되는 어셈블리를 포함합니다.

포함 된 JavaScript가 있는 HTML 리소스의 문제에 대한 줄 번호 참조가 올바르지 않습니다

HTML 웹 리소스가 솔루션 검사기 내에서 처리되면 HTML 웹 리소스는 HTML 웹 리소스 내에서 JavaScript와 별도로 처리됩니다. 이로 인해 HTML 웹 리소스의 <script> 내에서 발견된 위반의 줄 번호가 올바르지 않습니다.

웹 리소스에 대한 웹 지원되지 않는 구문 문제

솔루션 검사기는 ECMAScript 2015(ES6) 이상부터 ECMAScript 2018(ES9)까지 구문을 위한 전역 변수를 지원합니다. 솔루션 검사기가 ES6 이후의 전역 변수나 ES9 이후 구문을 사용하여 JavaScript를 분석하면 웹 리소스가 웹을 지원하지 않는 문제가 있습니다.

호출 범위를 기반으로 하는 플러그 인 및 워크플로 활동에 대해 여러 가지 위반이 보고됨

문제는 호출 컨텍스트에만 관련된 플러그 인 및 워크플로 작업 규칙의 경우 솔루션 검사기 도구는 IPlugin 인터페이스 구현에서 분석을 시작하고 호출 그래프를 트래버스하여 해당 구현의 범위 내에서 문제를 검색합니다. 경우에 따라 많은 호출 경로가 문제가 발견되는 동일한 위치에 도착할 수 있습니다. 이 문제는 호출 범위와 관련이 있으므로 이 도구는 해당 범위를 기반으로 보고할 수 있으므로 별개의 위치보다 더 나은 영향을 제공합니다. 결과적으로 여러 문제를 해결해야 하는 단일 위치를 참조할 수 있습니다.

app-formula-issues-high는 디자인 모드에 표시된 것과 다른 오류 수를 표시할 수 있습니다.

솔루션 검사기는 테스트의 오류를 포함하여 앱에서 발견된 오류 수를 나열합니다. 디자인 모드에서 앱 검사기는 화면 컨트롤 및 구성 요소의 오류만 표시합니다. 디자인 모드에서 앱 검사기에 표시된 오류 수가 더 적으면 Test Studio를 열고 테스트에 사용된 식에서 오류를 검색합니다.

코드 구성 요소에 대해 보고된 솔루션 검사기 위반

솔루션 검사기는 디버그 모드에서 빌드된 코드 구성 요소가 있는 솔루션에서 실행할 때 여러 위반을 보고합니다. 디버그 모드에서 발생하는 일반적인 오류 중 하나는 web-avoid-eval입니다. 솔루션 검사기는 프로덕션 사용을 위한 코드의 유효성을 검사하기 위한 것이므로 코드 구성 요소는 빌딩 시스템에 따라 적절한 buildMode(npm run build -- --buildMode production 또는 msbuild /p:configuration=Release)를 사용하여 빌드해야 합니다. 추가 정보: 코드 구성 요소 생성 및 빌드

코드 구성 요소에 의해 도입된 bundle.js에서 오류가 발생하는 경우 이 파일을 분석에서 제외할 수 있습니다. 추가 정보: Microsoft.PowerApps.Checker.PowerShell 모듈 및 PAC CLI

참조 항목

Dataverse에 대한 모범 사례 및 지침

모델 기반 앱에 대한 모범 사례 및 지침

참고

귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)

이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).