모델 기반 앱에서 컨트롤은 양식의 HTML 요소를 나타냅니다. 일부 컨트롤은 특정 열에 바인딩되는 반면 다른 컨트롤은 형식에 추가된 IFRAME, 웹 리소스 또는 subgrid와 같은 언바운드 컨트롤을 나타냅니다.
컨트롤 개체는 컨트롤 의 프레젠테이션 또는 동작을 변경하고 해당 열을 식별하는 메서드를 제공합니다. 다음 컬렉션 중 하나를 사용하여 제어에 액세스합니다.
- formContext.ui.controls
- formContext.ui Section.controls
- formContext.data.entityAttribute.controls
formContext입니다. getControl 메서드는 formContext.ui.controls.get에 액세스하는 바로 가기 메서드입니다.
비고
열에 연결된 컨트롤에 대해 작업을 수행하는 경우 컨트롤이 페이지에 두 번 이상 표시될 수 있습니다. 일반적으로 열에 대해 각 컨트롤에 대해 동일한 작업을 수행해야 합니다. 열 컨트롤 컬렉션을 반복하고 각 컨트롤에 대해 작업을 수행할 수 있습니다.
컨트롤은 형식별로 분류됩니다. getControlType 메서드를 사용하여 컨트롤의 형식을 확인합니다. 특정 컨트롤 메서드는 특정 유형의 컨트롤에만 사용할 수 있습니다.
이 문서에서는 각 컨트롤 형식에 사용할 수 있는 메서드에 대한 정보를 제공합니다.
표준 컨트롤 형식
이러한 메서드는 표준 컨트롤에 사용할 수 있습니다.
| Method | Description |
|---|---|
| addNotification | 선택적 작업이 있는 오류 또는 권장 사항 알림을 표시합니다. |
| clearNotification | 컨트롤에서 알림을 제거합니다. |
| getAttribute | 컨트롤이 바인딩된 열을 반환합니다. |
| getControlType | 컨트롤의 형식을 반환합니다. |
| getDisabled | 컨트롤을 사용할 수 없는지 여부를 반환합니다. |
| getLabel | 컨트롤의 레이블을 반환합니다. |
| getName | 컨트롤의 이름을 반환합니다. |
| getOutputs | 컨트롤의 출력 속성 사전을 반환합니다. |
| getParent | 컨트롤이 포함된 섹션을 반환합니다. |
| getVisible | 컨트롤이 표시되는지 여부를 반환합니다. |
| setDisabled | 컨트롤을 사용하거나 사용하지 않도록 설정합니다. |
| setFocus | 포커스를 컨트롤로 이동합니다. |
| setLabel | 컨트롤의 레이블을 변경합니다. |
| setNotification | 데이터가 유효하지 않음을 나타내는 오류 메시지를 표시합니다. |
| setVisible | 컨트롤을 표시하거나 숨깁니다. |
표준 컨트롤에 대한 다음 메서드는 사용되지 않습니다. addOnKeyPress, fireOnKeyPress 및 removeOnKeyPress.
IFRAME 컨트롤 형식
이러한 메서드는 IFRAME 컨트롤에 사용할 수 있습니다.
| Method | Description |
|---|---|
| getContentWindow | IFRAME 또는 웹 리소스의 콘텐츠 창을 반환합니다. |
| getControlType | 컨트롤의 형식을 반환합니다. |
| getDisabled | 컨트롤을 사용할 수 없는지 여부를 반환합니다. |
| getInitialUrl | IFRAME에 대해 구성된 기본 URL을 반환합니다. |
| getLabel | 컨트롤의 레이블을 반환합니다. |
| getName | 컨트롤의 이름을 반환합니다. |
| getObject | IFRAME 또는 웹 리소스를 나타내는 양식 개체를 반환합니다. |
| getParent | 컨트롤이 포함된 섹션을 반환합니다. |
| getSrc | IFRAME 또는 웹 리소스에 현재 표시되는 URL을 반환합니다. |
| getVisible | 컨트롤이 표시되는지 여부를 반환합니다. |
| setDisabled | 컨트롤을 사용하거나 사용하지 않도록 설정합니다. |
| setFocus | 포커스를 컨트롤로 이동합니다. |
| setLabel | 컨트롤의 레이블을 변경합니다. |
| setSrc | IFRAME 또는 웹 리소스에 표시할 URL을 설정합니다. |
| setVisible | 컨트롤을 표시하거나 숨깁니다. |
Kbsearch(기술 자료 검색) 컨트롤 형식
이러한 메서드는 기술 자료 검색 컨트롤에 사용할 수 있습니다.
| Method | Description |
|---|---|
| addOnPostSearch | 검색이 완료된 후 실행되는 이벤트 처리기를 추가합니다. |
| addOnResultOpened | 검색 결과가 열릴 때 실행되는 이벤트 처리기를 추가합니다. |
| addOnSelection | 검색 결과를 선택할 때 실행되는 이벤트 처리기를 추가합니다. |
| getControlType | 컨트롤의 형식을 반환합니다. |
| getDisabled | 컨트롤을 사용할 수 없는지 여부를 반환합니다. |
| getLabel | 컨트롤의 레이블을 반환합니다. |
| getName | 컨트롤의 이름을 반환합니다. |
| getParent | 컨트롤이 포함된 섹션을 반환합니다. |
| getSearchQuery | 검색 조건으로 사용되는 텍스트를 반환합니다. |
| getSelectedResults | 현재 선택한 검색 결과를 반환합니다. |
| getTotalResultCount | 검색 결과 수를 반환합니다. |
| getVisible | 컨트롤이 표시되는지 여부를 반환합니다. |
| openSearchResult | 지정된 검색 결과를 엽니다. |
| removeOnPostSearch | 검색 완료를 위한 이벤트 처리기를 제거합니다. |
| removeOnResultOpened | 검색 결과를 열기 위한 이벤트 처리기를 제거합니다. |
| removeOnSelection | 검색 결과를 선택하기 위한 이벤트 처리기를 제거합니다. |
| setFocus | 포커스를 컨트롤로 이동합니다. |
| setLabel | 컨트롤의 레이블을 변경합니다. |
| setSearchQuery | 검색 조건으로 사용되는 텍스트를 설정합니다. |
| setVisible | 컨트롤을 표시하거나 숨깁니다. |
비고
기술 자료 검색 컨트롤을 소셜 창에 추가하면 컨트롤 이름은 .입니다 searchwidgetcontrol_notescontrol. 이 이름은 바꿀 수 없어.
조회 컨트롤 형식
이러한 메서드는 조회 컨트롤에 사용할 수 있습니다.
| Method | Description |
|---|---|
| addCustomFilter | AND를 사용하여 기존 필터와 결합된 조회 결과에 필터를 추가합니다. |
| addCustomView | 조회 대화 상자에 보기를 추가합니다. |
| addNotification | 선택적 작업이 있는 오류 또는 권장 사항 알림을 표시합니다. |
| addOnLookupTagClick | 조회 태그를 클릭할 때 실행되는 이벤트 처리기를 추가합니다. |
| addPreSearch | 조회 검색 전에 실행되는 이벤트 처리기를 추가합니다. |
| clearNotification | 컨트롤에서 알림을 제거합니다. |
| getAttribute | 컨트롤이 바인딩된 열을 반환합니다. |
| getControlType | 컨트롤의 형식을 반환합니다. |
| getDefaultView | 기본 조회 보기의 ID를 반환합니다. |
| getDisabled | 컨트롤을 사용할 수 없는지 여부를 반환합니다. |
| getEntityTypes | 조회에 허용되는 테이블 형식을 반환합니다. |
| getLabel | 컨트롤의 레이블을 반환합니다. |
| getName | 컨트롤의 이름을 반환합니다. |
| getParent | 컨트롤이 포함된 섹션을 반환합니다. |
| getVisible | 컨트롤이 표시되는지 여부를 반환합니다. |
| removeOnLookupTagClick | 조회 태그 클릭에 대한 이벤트 처리기를 제거합니다. |
| removePreSearch | 조회 검색 전에 실행되는 이벤트 처리기를 제거합니다. |
| setDefaultView | 조회 대화 상자에서 기본 보기를 설정합니다. |
| setDisabled | 컨트롤을 사용하거나 사용하지 않도록 설정합니다. |
| setEntityTypes | 조회에 허용되는 테이블 형식을 설정합니다. |
| setFocus | 포커스를 컨트롤로 이동합니다. |
| setLabel | 컨트롤의 레이블을 변경합니다. |
| setNotification | 데이터가 유효하지 않음을 나타내는 오류 메시지를 표시합니다. |
| setVisible | 컨트롤을 표시하거나 숨깁니다. |
선택 사항 및 선택 컨트롤 형식
선택 항목 및 선택 컨트롤에는 동일한 메서드 집합을 사용할 수 있습니다.
| Method | Description |
|---|---|
| addNotification | 선택적 작업이 있는 오류 또는 권장 사항 알림을 표시합니다. |
| addOption | 컨트롤에 옵션을 추가합니다. |
| clearNotification | 컨트롤에서 알림을 제거합니다. |
| clearOptions | 컨트롤에서 모든 옵션을 제거합니다. |
| getAttribute | 컨트롤이 바인딩된 열을 반환합니다. |
| getControlType | 컨트롤의 형식을 반환합니다. |
| getDisabled | 컨트롤을 사용할 수 없는지 여부를 반환합니다. |
| getLabel | 컨트롤의 레이블을 반환합니다. |
| getName | 컨트롤의 이름을 반환합니다. |
| getOptions | 빈 옵션과 제거된 옵션 제외를 포함하여 사용 가능한 옵션을 반환합니다. |
| getParent | 컨트롤이 포함된 섹션을 반환합니다. |
| getVisible | 컨트롤이 표시되는지 여부를 반환합니다. |
| removeOption | 컨트롤에서 옵션을 제거합니다. |
| setDisabled | 컨트롤을 사용하거나 사용하지 않도록 설정합니다. |
| setFocus | 포커스를 컨트롤로 이동합니다. |
| setLabel | 컨트롤의 레이블을 변경합니다. |
| setNotification | 데이터가 유효하지 않음을 나타내는 오류 메시지를 표시합니다. |
| setVisible | 컨트롤을 표시하거나 숨깁니다. |
빠른 양식 컨트롤 유형
이 컨트롤 형식에 지원되는 메서드에 대한 자세한 내용은 formContext.ui.quickForms 를 참조하세요.
Subgrid 컨트롤 형식
이 컨트롤 형식에 대해 지원되는 메서드에 대한 자세한 내용은 그리드 및 하위 그리드 를 참조하세요.
타임라인 벽 컨트롤 유형
타임라인 컨트롤은 게시물, 활동 및 메모를 통합 보기로 표시합니다. 이러한 메서드는 이 컨트롤 형식에 사용할 수 있습니다.
| Method | Description |
|---|---|
| getControlType | 컨트롤의 형식을 반환합니다. |
| getDisabled | 컨트롤을 사용할 수 없는지 여부를 반환합니다. |
| getLabel | 컨트롤의 레이블을 반환합니다. |
| getName | 컨트롤의 이름을 반환합니다. |
| getParent | 컨트롤이 포함된 섹션을 반환합니다. |
| getVisible | 컨트롤이 표시되는지 여부를 반환합니다. |
| 리프레쉬 | 타임라인에 표시된 데이터를 새로 고칩니다. |
| setDisabled | 컨트롤을 사용하거나 사용하지 않도록 설정합니다. |
| setFocus | 포커스를 컨트롤로 이동합니다. |
| setLabel | 컨트롤의 레이블을 변경합니다. |
| setVisible | 컨트롤을 표시하거나 숨깁니다. |
타이머 컨트롤 형식
이러한 메서드는 타이머 컨트롤에 사용할 수 있습니다.
| Method | Description |
|---|---|
| getControlType | 컨트롤의 형식을 반환합니다. |
| getDisabled | 컨트롤을 사용할 수 없는지 여부를 반환합니다. |
| getLabel | 컨트롤의 레이블을 반환합니다. |
| getName | 컨트롤의 이름을 반환합니다. |
| getParent | 컨트롤이 포함된 섹션을 반환합니다. |
| getState | 타이머의 현재 상태를 반환합니다. |
| getVisible | 컨트롤이 표시되는지 여부를 반환합니다. |
| 리프레쉬 | 타이머에 표시된 데이터를 새로 고칩니다. |
| setDisabled | 컨트롤을 사용하거나 사용하지 않도록 설정합니다. |
| setFocus | 포커스를 컨트롤로 이동합니다. |
| setLabel | 컨트롤의 레이블을 변경합니다. |
| setVisible | 컨트롤을 표시하거나 숨깁니다. |
웹 리소스 제어 유형
웹 리소스 컨트롤에는 iframe 컨트롤과 동일한 메서드 집합을 사용할 수 있습니다. iframe 컨트롤 형식을 참조하세요.
양식 구성 요소 컨트롤 형식
양식 구성 요소 컨트롤 형식에는 기본 폼에서 formContext 와 동일한 메서드 집합을 사용할 수 있습니다. 양식 구성 요소 동작 > 클라이언트 API를 참조하세요.