포함된 캔버스 앱은 호스트 모델 기반 양식에서 미리 정의된 작업을 수행하는 기능을 제공합니다. 이러한 작업을 통해 제작자는 호스트 모델 기반 양식을 탐색, 새로 고침 및 저장할 수 있습니다. 이러한 작업을 사용하면 포함된 캔버스 앱이 모델 기반 양식 및 모델 기반 앱의 더 중요한 부분으로 작동할 수 있습니다.
이제 ModelDrivenFormIntegration 개체에는 제조업체가 호스트 모델 기반 양식에서 작업을 수행할 수 있도록 하는 다음과 같은 새로운 메서드가 포함되어 있습니다.
NavigateToMainForm(entityName, mainFormName, recordId)
호스트 모델 기반 폼을 기본 폼으로 이동하고 지정된 행을 표시합니다.
- entityName - 기본 폼의 부모 테이블을 지정하는 필수 문자열 매개 변수입니다.
- formName - 탐색할 기본 폼의 이름을 지정하는 필수 문자열 매개 변수입니다.
- recordId - 기본 폼에 표시할 행의 ID를 지정하는 필수 문자열 매개 변수입니다.
NavigateToMainForm 메서드를 호출하면 다음 오류 메시지가 표시 될 수 있습니다.
| 오류 메시지 | 문제 해결 지침 |
|---|---|
| 테이블을 찾을 수 없음: [EntityName] | entityName 매개 변수의 값을 확인하고 유효한 테이블 이름이며 사용자가 액세스할 수 있는지 확인하세요. |
| 폼을 찾을 수 없음: [FormName] | mainFormName 매개 변수의 값을 확인하고 유효한 기본 양식 이름이며 사용자가 해당 매개 변수에 액세스할 수 있는지 확인하세요. |
| 행을 로드하는 동안 문제가 발생했습니다. | recordId 매개 변수의 값을 확인하고 유효한 행 ID이고 사용자가 해당 매개 변수에 액세스할 수 있는지 확인하세요. |
NavigateToView(entityName, viewName)
호스트 모델 기반 폼을 보기로 이동합니다.
- entityName - 뷰의 부모 테이블을 지정하는 필수 문자열 매개 변수입니다.
- viewName - 탐색할 기본 폼의 이름을 지정하는 필수 문자열 매개 변수입니다.
NavigateToView 메서드를 호출하면 다음 오류 메시지가 표시 될 수 있습니다.
| 오류 메시지 | 문제 해결 지침 |
|---|---|
| 테이블을 찾을 수 없음: [EntityName] | entityName 매개 변수의 값을 확인하고 유효한 테이블 이름이며 사용자가 액세스할 수 있는지 확인하세요. |
| 뷰를 찾을 수 없음: [ViewName] | viewName 매개 변수의 값을 확인하고 유효한 뷰 이름이며 사용자에게 액세스 권한이 있는지 확인하세요. |
OpenQuickCreateForm(entityName)
테이블에 대한 기본 빠른 만들기 양식을 엽니다.
- entityName - 빠른 만들기 양식의 부모 테이블을 지정하는 필수 문자열 매개 변수입니다.
OpenQuickCreateForm 메서드를 호출하면 다음 오류 메시지가 표시 될 수 있습니다.
| 오류 메시지 | 문제 해결 지침 |
|---|---|
| 테이블을 찾을 수 없음: [EntityName] | entityName 매개 변수의 값을 확인하고 유효한 테이블 이름이며 사용자가 액세스할 수 있는지 확인하세요. |
RefreshForm(showPrompt)
호스트 모델 기반 양식의 데이터를 새로 고칩니다.
- showPrompt - 호스트 모델 기반 양식에 저장되지 않은 데이터를 저장하기 전에 사용자에게 확인 프롬프트를 표시해야 하는지 여부를 나타내는 필수 부울 매개 변수입니다. 값은 "true" 또는 "false"여야 합니다.
RefreshForm 메서드를 호출하면 다음 오류 메시지가 표시 될 수 있습니다.
| 오류 메시지 | 문제 해결 지침 |
|---|---|
| 매개 변수 값으로 "true" 또는 "false"를 사용하세요. | showPrompt 매개 변수의 값을 확인하고 "true" 또는 "false"인지 확인하세요. |
SaveForm()
호스트 모델 기반 양식에 데이터를 저장합니다.
비고
기능을 사용할 수 있게 되기 전에 만든 포함된 캔버스 앱에서 미리 정의된 작업을 수행하는 메서드에 대한 IntelliSense가 표시되지 않으면 다음을 수행합니다. 앱을 저장하고 닫고 다시 엽니다.
참고하십시오
모델 기반 양식에 캔버스 앱 포함하기
모델 기반 양식에 포함된 캔버스 앱 추가
모델 기반 양식에 포함된 캔버스 앱 편집
모델 기반 양식에 포함된 캔버스 앱의 화면 크기 및 방향 사용자 지정
ModelDrivenFormIntegration 컨트롤의 속성 및 동작
포함된 캔버스 앱 공유
포함된 캔버스 앱 작업 지침
공개 미리 보기 릴리스를 사용하여 만든 모델 기반 양식에 포함된 캔버스 엡을 최신 버전으로 마이그레이션