양식에서 이벤트 처리기 구성
이 항목은 Dynamics 365 Customer Engagement (on-premises)에 적용됩니다. 이 항목의 Power Apps 버전은 다음을 참조하십시오. 모델 기반 앱 양식 이벤트 처리기 구성
Dynamics 365 Customer Engagement (on-premises) 양식에 대한 양식 이벤트 처리기는 양식의 다음 영역에 대해 구성할 수 있습니다.
| Element(요소) | 이벤트 | 설명 |
|---|---|---|
| 양식 | OnLoad |
양식이 로드될 때 발생합니다. |
OnSave |
데이터를 저장할 때 발생합니다. | |
| 탭 | TabStateChange |
탭이 확장되거나 축소될 때 발생합니다. |
| 필드 | OnChange |
필드의 데이터가 변경되고 컨트롤에서 포커스를 잃을 때 발생합니다. |
| IFRAME | OnReadyStateComplete |
IFRAME의 내용을 로드할 때 발생합니다. |
이벤트 처리기는 JavaScript 웹 리소스에 대한 참조와 이벤트가 발생할 때 실행하는 해당 웹 리소스 내에 정의된 함수로 구성됩니다. 각 요소는 최대 50개까지 개별 이벤트 처리기를 구성할 수 있습니다.
중요
이벤트 처리기를 잘못 구성하면 스크립트 오류가 발생하여 양식이 로드되지 않거나 제대로 작동하지 않을 수 있습니다. 스크립트의 개발자가 아닌 경우 스크립트에 필요한 구성 옵션에 대해 정확히 알고 있어야 합니다.
신뢰할 수 있는 원본에서 가져오지 않은 라이브러리를 사용하여 스크립트 이벤트 처리기를 구성하지 마십시오. 스크립트는 사용자가 수행할 수 있는 모든 작업을 수행하는 데 사용될 수 있으며 잘못 작성된 스크립트는 양식의 성능을 현저하게 손상시킬 수 있습니다.
이벤트 처리기를 구성한 후에는 제대로 작동하는지 확인하기 위해 항상 테스트합니다.
이벤트 처리기를 구성하려면
양식 편집기에서 처리기를 구성할 이벤트가 있는 요소를 선택합니다.
홈 탭의 편집 그룹에서 속성 변경을 클릭하거나 요소를 두 번 선택합니다.
요소 속성 대화 상자에서 이벤트 탭을 선택합니다.
양식 라이브러리 영역을 확장합니다. 이벤트 처리기로 설정하려는 함수가 포함된 라이브러리가 목록에 없으면 추가합니다.
이벤트 처리기에 양식 라이브러리를 추가하려면
이벤트 목록의 양식 라이브러리 섹션에서 추가를 선택합니다.
사용 가능한 웹 리소스 목록에서 JavaScript 웹 리소스를 찾습니다. 선택한 추가를 선택합니다.
필요한 JavaScript 웹 리소스가 없으면 새로 만들기를 선택하여 새 웹 리소스 양식을 열고 만듭니다.
JavaScript 웹 리소스를 만들려면
웹 리소스 양식에서 다음 속성을 설정합니다.
속성 값 이름 필수 특성: 웹 리소스 이름을 입력합니다. 표시 이름 필수 특성: 웹 리소스의 목록에 표시할 이름을 입력합니다. 설명 선택 사항. 웹 리소스에 대한 설명을 입력합니다. 유형 필수 특성: 스크립트(JScript)를 선택합니다. 언어 선택 사항. 조직에 사용할 수 있는 언어 중 하나를 선택합니다. 스크립트와 함께 제공된 경우 찾아보기 단추를 사용하여 파일을 찾아 업로드하는 것이 좋습니다.
또는 텍스트 편집기 단추를 선택하여 붙여넣거나 내용 편집 대화 상자에서 스크립트의 내용을 입력할 수 있습니다.
노트
이 간단한 텍스트 편집기는 스크립트의 정확성을 확인하는 기능을 제공하지 않으므로 일반적으로 Visual Studio와 같은 별도의 응용 프로그램을 사용하여 스크립트를 편집한 후 업로드해야 합니다.
저장을 선택하고 웹 리소스 대화 상자를 닫습니다.
만든 웹 리소스가 이제 레코드 조회 대화 상자에 선택되어 있습니다. 추가를 선택하여 대화 상자를 닫습니다.
이벤트 처리기 섹션에서 이벤트 처리기를 설정하려는 이벤트를 선택합니다.
추가를 선택하여 처리기 속성 대화 상자를 엽니다.
정보 탭에서 적합한 라이브러리를 선택하고 이벤트를 실행하는 함수의 이름을 입력합니다.
기본적으로 이벤트 처리기는 활성화됩니다. 이 이벤트를 사용하지 않으려면 활성화 확인란의 선택을 취소합니다.
일부 함수에는 함수에 전달되는 실행 컨텍스트가 필요합니다. 필요한 경우 실행 컨텍스트를 첫 번째 매개 변수로 전달을 선택합니다.
일부 함수는 함수의 동작을 제어하는 매개 변수 집합을 허용할 수 있습니다. 필요한 경우 함수로 전달되는 쉼표로 구분되는 매개 변수 목록에 입력합니다.
종속성 탭에서 종속 필드 영역에 스크립트가 종속되는 필드를 추가합니다.
확인을 클릭하여 처리기 속성 대화를 닫습니다.
이벤트 처리기를 입력할 때 녹색 화살표를 사용하여 함수를 위로 또는 아래로 이동하여 다른 함수에 상대적인 함수가 실행되는 순서를 조정할 수 있습니다.
확인을 선택하여 속성 대화 상자를 닫습니다.
저장을 선택하여 변경 내용을 저장합니다. 양식을 게시하려면 게시를 선택합니다.
노트
사용자 인터페이스(UI)를 사용하면 위/아래 녹색 화살표를 사용하여 스크립트가 로드되는 순서를 조정할 수 있지만 스크립트는 실제로 순차적으로 로드되지 않습니다.