다음을 통해 공유

Power Pages DevTools 확장

  • 아티클

Microsoft Edge DevTools용 Power Pages 확장은 Power Pages 사이트에서 작업하는 제작자 및 관리자의 개발 및 문제 해결 환경을 향상시키기 위해 설계된 개발자 도구입니다. Liquid 추적 메시지 및 서버 측 오류 메시지 표시와 같은 기능을 제공합니다. 이 도구를 사용하면 제작자와 관리자는 Power Pages 환경 내에서 문제를 효율적으로 식별, 진단 및 해결할 수 있습니다. Power Pages 확장 프로그램은 Liquid 코드에서 로깅 및 추적 기능을 활성화하고 오류 시나리오에 대한 명확한 인사이트를 제공함으로써 보다 원활한 개발 워크플로를 촉진하고 Power Pages 사이트의 전반적인 품질을 향상시킵니다.

참고

개발자 도구 확장은 현재 Microsoft Edge에서만 사용할 수 있습니다.

개발자 도구를 사용하려면 다음을 수행해야 합니다.

  • 브라우저 확장을 설치합니다.
  • 진단 설정을 사용하도록 설정합니다.
  • 서버 쪽 오류를 검토하고 완화 세부 정보를 따릅니다.
  • Liquid 코드를 사용하여 추가된 사용자 지정 로그 메시지를 봅니다.

브라우저 DevTools 확장 설치

Power Pages용 DevTools 확장을 설치하려면:

  1. Microsoft Edge용 Microsoft Power Pages 확장으로 이동하세요.
  2. 받기를 선택합니다.

진단 설정 사용

참고

사이트 공개 상태가 비공개인 경우 기본적으로 진단 설정이 활성화됩니다.

공개 웹 사이트에 대한 진단 설정을 활성화하려면:

  1. Power Pages Management 앱을 엽니다.
  2. UserTrace/Debug라는 이름으로 사이트 설정을 추가하거나 업데이트하세요.
  3. 값을 true로 설정합니다.

서버 쪽 오류 메시지 검토

진단 설정을 활성화하면 플랫폼은 서버에서 발생하는 모든 오류를 기록합니다. 이러한 서버 오류 메시지를 캡처하려면:

  1. Microsoft Edge 웹 브라우저를 엽니다.

  2. Power Pages 웹 사이트로 이동합니다.

  3. DevTools 브라우저를 엽니다.

  4. Power Pages 탭을 선택합니다.

    Power Pages 탭이 선택된 Microsoft Edge DevTools의 스크린샷.

  5. 오류가 발생한 시나리오를 재현합니다.

이 도구는 가능한 해결 방법과 함께 모든 서버 쪽 오류 메시지 목록을 표시합니다.

참고

현재는 제한된 수의 실패 오류 메시지만 표시될 수 있습니다. 그러나 각 후속 릴리스에는 다양한 유형의 오류에 대한 추가 오류 메시지가 포함됩니다.

다음은 몇 가지 오류 메시지 예시입니다.

  • 포털 연락처에 대해 LogonEnabled 속성이 false인 경우 로컬 로그인 공급자에 오류가 발생합니다.

    Power Pages 탭이 선택되고 오류 메시지 예가 표시된 Microsoft Edge DevTools의 스크린샷.

  • 외부 엔터티 검색이 제대로 구성되지 않았습니다.

Liquid를 사용하여 사용자 지정 메시지 기록

제작자는 Liquid 코드에 로그 문을 추가할 수 있습니다. Power Pages 사이트가 실행 중일 때 Liquid 코드에서 제작자가 추가한 로그는 Power Pages 개발자 도구 확장에 표시됩니다. 제작자는 Liquid 코드 내에 로그 문을 통합할 수 있습니다. 제작자가 포함한 이러한 로그는 진단 설정이 활성화되면 개발자 도구 확장에 표시됩니다.

Liquid 코드에서 다음 구문을 사용하여 사용자 지정 메시지를 기록할 수 있습니다.

{% log message:'Custom message' level:'Warning' %}

매개 변수 Description
로그 Liquid 개체 이름
메시지 기록할 사용자 지정 메시지를 나타내는 문자열
수준 메시지를 정보, 경고 또는 오류로 기록

예:

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}