Microsoft. PowerPages.onPagesClientApiReady
Power Pages 클라이언트 API 초기화는 페이지가 로드되는 즉시 발생하지 않습니다. 함수를 Microsoft.PowerPages.onPagesClientApiReady 사용하여 API 개체 $pages 가 준비되면 할당하므로 초기화가 완료된 후에만 스크립트가 페이지 API에 액세스할 수 있습니다. 두 가지 방법으로 초기화할 수 있습니다.
Important
별칭은 Microsoft.Dynamic365.Portal.onPagesClientApiReady 더 이상 사용되지 않습니다. 기존 스크립트가 계속 실행되도록 작동하지만 브라우저 콘솔에 일회성 경고를 쓰고 이후 릴리스에서 제거됩니다.
Microsoft.PowerPages.onPagesClientApiReady를 대신 사용하세요.
콜백 기반 API 준비 상태
API 개체가 준비되면 정의한 변수에 API 개체를 할당하는 콜백 함수를 사용합니다. 두 가지 예제에서는 다음 방법을 보여 줍니다.
익명 함수를 사용하여 다음을 수행합니다.
Microsoft.PowerPages.onPagesClientApiReady(($pages) => {
const forms = $pages.currentPage.forms.getAll();
console.log(`Found ${forms.length} forms on the page.`);
});
명명된 함수를 사용하여 다음을 수행합니다.
function start($pages){
const forms = $pages.currentPage.forms.getAll();
console.log(`Found ${forms.length} forms on the page.`);
}
Microsoft.PowerPages.onPagesClientApiReady(start)
Promise/await 기반 API 준비
await를 사용하여 더 깨끗한 비동기 흐름에 대해 함수에서 Microsoft.PowerPages.onPagesClientApiReady 반환한 약속을 처리합니다.
let $pages = await Microsoft.PowerPages.onPagesClientApiReady();
const forms = $pages.currentPage.forms.getAll();
console.log(`Found ${forms.length} forms on the page.`);
각 방법을 사용하는 경우
다음 표에서는 각 방법을 사용하는 시기를 설명합니다.
| Approach | 사용 시기 |
|---|---|
| 콜백 기반 API 준비 상태 | 지원하지 async/await않는 이전 브라우저 또는 레거시 스크립트를 지원해야 하거나 API가 준비되면 실행되는 여러 처리기를 등록하려는 경우에 사용합니다. 이벤트 기반 패턴에 적합합니다. |
| Promise/await 기반 API 준비 | 더 깨끗하고 순차적인 코드를 지원하는 async/await 최신 JavaScript 환경에서 사용합니다. 실행을 계속하기 전에 준비 중인 API에 따라 논리가 달라지는 경우에 가장 좋습니다. |
팁
코드베이스에서 이미 사용하는 async/await경우 일관성을 위해 Promise 기반 접근 방식을 선호합니다.
이 문서 및 클라이언트 API 컨트롤 형식 의 예제에서는 콜백과 함께 async 콜백 기반 패턴을 사용하므로 각 예제는 비동기 메서드를 호출할 때 사용할 await 수 있습니다. 사용자 고유의 코드에서 async 키워드를 사용하지 await않는 경우 키워드를 생략합니다. 각 예제에서는 하나 이상의 API 호출을 보여 줍니다. 에이전트 예제는 이전 예제에서 정의한 값을 기반으로 합니다. 여러 API를 결합하여 전체 시나리오를 구현하는 예제는 Power Pages Client API 예제를 참조하세요.