그리드 및 뷰에서 데이터를 사용하는 속성과 메서드를 제공합니다.
사용할 수 있는 대상
모델 기반 및 캔버스 앱.
속성
columns
이 데이터 세트에서 사용할 수 있는 열 집합입니다. 모델 기반 앱과 캔버스 앱 모두에서 지원됩니다.
형식: Column[]
오류
데이터 검색에서 오류가 발생했는지 여부입니다. 모델 기반 앱과 캔버스 앱 모두에서 지원됩니다.
형식: boolean
오류 코드
해당하는 경우 마지막으로 발생한 오류와 연결된 오류 코드입니다.
errorMessage
해당하는 경우 마지막으로 발생한 오류와 관련된 오류 메시지입니다.
형식: number | string
필터링
현재 쿼리에 대한 열 필터링입니다. 모델 기반 앱과 캔버스 앱 모두에서 지원됩니다. 설정 context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>)하여 데이터 세트에 대한 필터링을 구성할 수 있습니다. 필터가 설정되면 호출 context.parameters.[dataset_property_name].refresh() 은 데이터 원본에서 필터링된 데이터를 검색합니다.
| 가치 | 조건부 연산자 | 모델 기반 앱 | 캔버스 앱 |
|---|---|---|---|
| -1 | None | Yes | Yes |
| 0 | 같다 | Yes | Yes |
| 1 | NotEqual | Yes | Yes |
| 2 | GreaterThan | Yes | Yes |
| 3 | LessThan | Yes | Yes |
| 4 | GreaterEqual | Yes | Yes |
| 5 | LessEqual | Yes | Yes |
| 6 | 좋다 | Yes | Yes |
| 7 | NotLike | 아니오 | Yes |
| 8 | In | Yes | Yes |
| 12 | 없음 | Yes | Yes |
| 13 | NotNull | 아니오 | Yes |
| 14 | 어제 | Yes | 아니오 |
| 15 | 오늘 | Yes | 아니오 |
| 16 | Tomorrow | Yes | 아니오 |
| 17 | Last7Days | Yes | 아니오 |
| 18 | Next7Days | Yes | 아니오 |
| 19 | LastWeek | Yes | 아니오 |
| 20 | ThisWeek | Yes | 아니오 |
| 22 (이십이) | LastMonth | Yes | 아니오 |
| 23 | ThisMonth | Yes | 아니오 |
| 이십오 (25) | 설정 | Yes | 아니오 |
| 26 | OnOrBefore | Yes | 아니오 |
| 27 | OnOrAfter | Yes | 아니오 |
| 28 | LastYear | Yes | 아니오 |
| 이십구 | ThisYear | Yes | 아니오 |
| 33 | LastXDays | Yes | 아니오 |
| 34 | NextXDays | Yes | 아니오 |
| 37 | LastXMonths | Yes | 아니오 |
| 38 | NextXMonths | Yes | 아니오 |
| 49 | 포함함 | Yes | Yes |
| 54 | BeginWith | 아니오 | Yes |
| 55 | DoesNotBeginWidth | 아니오 | Yes |
| 56 | EndsWidth | 아니오 | Yes |
| 57 | DesNotEndWith | 아니오 | Yes |
| 70 | InFiscalPeriodAndYear | Yes | 아니오 |
| 75 | 위 | Yes | Yes |
| 76 | 아래 | Yes | Yes |
| 77 | NotUnder | Yes | Yes |
| 78 | AboveOrEqual | Yes | Yes |
| 79 | UnderOrEqual | Yes | Yes |
| 87 | ContainValues | Yes | Yes |
| 88 | DoesNotContainValues | 아니오 | Yes |
비고
필터링 기능은 Dataverse 데이터 원본에서만 사용할 수 있습니다.
형식: 필터링
연결
연결된 테이블 정보를 정의합니다. 모델 기반 앱에서만 지원됩니다.
형식: 연결
로드
데이터 세트가 로드 중인지 여부를 나타냅니다. 모델 기반 앱과 캔버스 앱 모두에서 지원됩니다.
형식: boolean
페이징
페이지 매김 상태 및 작업입니다. 모델 기반 앱과 캔버스 앱 모두에서 지원됩니다. 페이징 정보는 .를 사용하여 context.parameters.[dataset_property_name].paging 데이터 세트에 액세스하고 구성할 수 있습니다.
비고
Dataverse 데이터 원본은 캔버스 앱에 totalRecordCount 대한 페이징 내 개체를 반환하지 않습니다. 대신 페치할 레코드가 더 있는지 확인하고 사용합니다 hasNextPagehasPreviousPage .
데이터 세트 구성 요소는 페이지당 검색된 레코드 수를 변경하는 데 사용할 context.parameters.[dataset_property_name].paging.setPageSize(pageSize) 수 있습니다.
형식: 페이징
레코드
ID를 전체 레코드 개체에 매핑합니다. 모델 기반 앱과 캔버스 앱 모두에서 지원됩니다.
형식: EntityRecord
sortedRecordIds
데이터 세트에 있는 레코드의 ID로, 쿼리 응답 결과에 따라 순서를 지정합니다. 모델 기반 앱과 캔버스 앱 모두에서 지원됩니다.
형식: string[]
정렬
현재 쿼리의 정렬 상태입니다. 모델 기반 앱과 캔버스 앱 모두에서 지원됩니다. 설정 context.parameters.[dataset_property_name].sorting = [SortStatus]하여 데이터 세트에 대해 정렬을 구성할 수 있습니다. 정렬이 구성되면 호출 context.parameters.[dataset_property_name].refresh() 은 데이터 원본에서 정렬된 데이터를 검색합니다.
비고
정렬 기능은 Dataverse 데이터 원본에서만 사용할 수 있습니다.
또한 정렬이 다시 구성된 경우 필터가 다시 설정됩니다. context.parameters.[dataset_property_name].filtering
형식: SortStatus[]
메서드
| 메서드 | Description | 사용할 수 있는 대상 |
|---|---|---|
| addColumn | 열 집합에 열을 추가합니다. | 모델 기반 앱 |
| clearSelectedRecordIds | 선택한 레코드 ID 목록을 지웁니다. | 모델 기반 및 캔버스 앱 |
| delete | 데이터 원본에서 레코드를 삭제합니다. | 캔버스 앱 |
| getCommands | 데이터 세트에 대한 명령입니다. | 캔버스 앱 |
| getDataSetCapabilities | 데이터 세트에 대한 기능입니다. | 캔버스 앱 |
| getSelectedRecordIds | 선택한 모든 레코드 ID를 검색합니다. | 모델 기반 및 캔버스 앱 |
| getTargetEntityType | 대상 테이블 형식 이름을 반환합니다. | 모델 기반 및 캔버스 앱 |
| getTitle | 데이터 세트 속성에서 사용하는 보기 표시 이름을 검색합니다. | 모델 기반 및 캔버스 앱 |
| getViewId | 데이터 세트 매개 변수에 사용되는 뷰의 ID를 반환합니다. | 모델 기반 및 캔버스 앱 |
| newRecord | 컨트롤에 대한 로컬 레코드 개체를 초기화하여 값을 설정합니다. 컨트롤은 변경 사항을 유지하기 위해 새로 만든 레코드에서 메서드를 호출 save() 해야 합니다. |
캔버스 앱 |
| openDatasetItem | 지정된 EntityReference에 대한 데이터 세트 항목을 엽니다. 명령 단추 ID Mscrm.OpenRecordItem가 있는 명령이 있는지 확인합니다. 있는 경우 명령을 실행합니다. 그렇지 않으면 EntityReference의 연결된 형식으로 이동합니다. |
모델 기반 및 캔버스 앱 |
| 리프레쉬 | 필터, 정렬, 연결, 새 열에 따라 데이터 세트를 새로 고칩니다. 또한 새로 고침은 페이징을 1페이지로 다시 설정합니다. | 모델 기반 및 캔버스 앱 |
| retrieveRecordCommand | 레코드의 연결된 명령을 검색합니다. 매니페스트에 여러 데이터 세트가 있는 경우 retrieveRecordCommand는 첫 번째 데이터 세트에 대한 명령을 반환합니다. | 모델 기반 |
| setSelectedRecordIds | 선택한 레코드의 ID를 설정합니다. | 모델 기반 및 캔버스 앱 |
조회 열
이제 Dataverse 테이블의 조회 열을 검색할 수 있습니다. 캔버스 앱의 경우 조회 열이 데이터 세트에 포함된 경우 참조된 레코드의 모든 열이 검색됩니다.
GetFormattedValue 는 이 열에 대한 JSON 문자열을 반환합니다.
GetValue 메서드는 JSON 개체를 직접 반환합니다.
Example
데이터 세트 메서드를 구현하는 방법에 대한 자세한 내용은 DataSet Grid 구성 요소를 참조하세요.