DataSourceInfo 함수
적용 대상:
Canvas 앱 모델 기반 앱
데이터 원본에 대한 정보를 제공합니다.
개요
데이터 원본은 사용자 환경을 최적화하도록 풍부한 정보를 제공할 수 있습니다.
열 수준 정보를 사용하여 사용자 입력의 유효성을 검사하고 Patch 함수를 사용하기 전에 사용자에게 즉각적인 피드백을 제공할 수 있습니다. Validate 함수는 이와 동일한 정보를 사용합니다.
예를 들어 데이터 원본 수준의 정보를 사용하여 레코드를 편집하고 생성할 권한이 없는 사용자에 대한 편집 및 새로 만들기 단추를 비활성화하거나 숨길 수 있습니다.
데이터 원본이 제공하는 정보의 양은 전혀 제공하지 않는 경우를 포함하여 다양합니다. 컬렉션 은 정보를 제공하지 않습니다. 정보가 제공되지 않으면 기본값이 사용되거나 공백이 반환됩니다.
노트
현재 DataSourceInfo 함수는 Microsoft Lists에서 지원되지 않습니다.
Description
열 정보
DataSourceInfo를 사용하면 데이터 원본의 특정 열에 대한 정보를 얻을 수 있습니다.
| 정보 인수 | 결과 유형 | 설명 |
|---|---|---|
| DataSourceInfo.DisplayName | 문자열 | 열의 표시 이름입니다. 표시 이름을 정의하지 않으면 열 이름이 반환됩니다. |
| 데이터소스정보.최대길이 | 번호 | 열이 보유할 수 있는 최대 문자 수입니다. 문자열이 포함된 열에만 적용됩니다. 최대값을 설정하지 않으면 공백이 반환됩니다. |
| 데이터소스정보.최대값 | 번호 | 열이 보유할 수 있는 최대 숫자 값입니다. 숫자가 포함된 열에만 적용됩니다. 최대값을 설정하지 않으면 공백이 반환됩니다. |
| 데이터소스정보.최소값 | 번호 | 열이 보유할 수 있는 최소 숫자 값입니다. 숫자가 포함된 열에만 적용됩니다. 최소값을 설정하지 않으면 공백이 반환됩니다. |
| 데이터소스정보.필수 | Boolean | 이 열에 값이 필요한가요? 데이터 원본에 설정하지 않으면 false가 반환됩니다. |
세 번째 인수는 문자열 형식의 열 이름입니다. 예를 들어 People 컬렉션의 Phone 열은 큰따옴표를 포함하여 "Phone"으로 전달됩니다.
데이터 원본 정보
DataSourceInfo를 사용하여 데이터 원본 전체에 대한 정보를 얻을 수도 있습니다.
| 정보 인수 | 결과 유형 | 설명 |
|---|---|---|
| 데이터소스정보.허용값 | Boolean | 이 데이터 원본에 대해 사용자에게 부여할 수 있는 권한 유형은 무엇인가요? 데이터 원본에 설정하지 않으면 공백이 반환됩니다. |
| DataSourceInfo.CreatePermission | Boolean | 현재 사용자에게 이 데이터 원본에 레코드를 만들 권한이 있나요? 데이터 원본에 설정하지 않으면 true가 반환됩니다. |
| DataSourceInfo.삭제권한 | Boolean | 현재 사용자에게 이 데이터 원본의 레코드를 삭제할 권한이 있나요? 데이터 원본에 설정하지 않으면 true가 반환됩니다. |
| DataSourceInfo.편집권한 | Boolean | 현재 사용자에게 이 데이터 원본의 레코드를 편집할 권한이 있나요? 데이터 원본에 설정하지 않으면 true가 반환됩니다. |
| DataSourceInfo.ReadPermission | Boolean | 현재 사용자에게 이 데이터 원본의 레코드를 읽을 권한이 있나요? 데이터 원본에 설정하지 않으면 true가 반환됩니다. |
노트
DataSourceInfo 는 현재 사용자에게 요청된 권한이 있는지 확인할 수 없는 경우 true 를 반환합니다. 실제 작업을 수행할 때 서버에서 권한을 다시 확인하고 허용되지 않으면 오류가 표시됩니다. 이때 DataSourceInfo를 통한 권한 확인은 Microsoft Dataverse를 사용할 때만 가능합니다.
구문
DataSourceInfo( 데이터소스, 정보 [, 열이름] )
- DataSource – 필수. 사용할 데이터 원본입니다.
- 정보 – 필수. 검색할 정보 유형입니다.
- ColumnName – 선택 사항. 열 수준 정보를 검색할 열 이름입니다. 데이터 원본 레벨에 대한 정보는 ColumnName 인수를 사용할 수 없습니다.
참고
버전 3.24042 이전의 Power Apps에서 열 이름은 큰따옴표를 사용하여 텍스트 문자열로 지정되었으며 데이터 원본에 연결된 경우 논리적 이름이어야 했습니다. 예를 들어 큰따옴표가 있는 논리 이름 "cr43e_name"이 따옴표가 없는 표시 이름 Name 대신 사용되었습니다. 공백이 포함된 열 이름이 포함된 SharePoint 및 Excel 데이터 원본의 경우 각 공백은 "_x0020_"로 지정되었습니다. 예를 들어 "열 이름"은 "Column_x0020_Name"으로 지정되었습니다. 이 버전 이후 모든 앱은 이 문서에 설명된 새로운 구문으로 자동 업데이트되었습니다.
예
이 섹션의 예제에서는 IceCream이라는 데이터 원본을 사용합니다.
데이터 원본에는 다음 정보도 제공됩니다.
- Quantity의 표시 이름은 "Quantity on Hand"입니다.
- Flavor의 최대 길이는 30자입니다.
- Flavor 열은 값을 포함해야 합니다. Quantity 열은 필요하지 않습니다.
- 최소 Quantity는 0입니다.
- 최대 Quantity는 100입니다.
- 현재 사용자는 IceCream 데이터 원본의 레코드를 읽고 편집할 수 있지만 레코드를 생성하거나 삭제할 수는 없습니다.
| 수식 | 설명 | 결과 |
|---|---|---|
| DataSourceInfo(아이스크림, DataSourceInfo.DisplayName, 수량) | IceCream 데이터 원본의 Quantity 열에 대한 표시 이름을 반환합니다. | "Quantity on Hand" |
| DataSourceInfo(아이스크림, DataSourceInfo.MaxLength, 플레이버) | IceCream 데이터 원본의 Flavor 열에 대한 문자열의 최대 길이를 반환합니다. | 30 |
| DataSourceInfo(아이스크림, DataSourceInfo.Required, 플레이버) | IceCream 데이터 원본의 Flavor 열이 필요한가요? | 진실 |
| DataSourceInfo(아이스크림, DataSourceInfo.필수, 수량) | IceCream 데이터 원본의 Quantity 열이 필요한가요? | 거짓 |
| DataSourceInfo(아이스크림, DataSourceInfo.MaxValue, 수량) | IceCream 데이터 원본의 Quantity 열에 대한 최대 숫자 값을 반환합니다. | 100 |
| DataSourceInfo(아이스크림, DataSourceInfo.MinValue, 수량) | IceCream 데이터 원본의 Quantity 열에 대한 최소 숫자 값을 반환합니다. | 0 |
| DataSourceInfo(아이스크림, DataSourceInfo.ReadPermission) | 현재 사용자가 IceCream 데이터 원본의 레코드를 읽을 수 있나요? | 진실 |
| DataSourceInfo(IceCream, DataSourceInfo.EditPermission) | 현재 사용자가 IceCream 데이터 원본의 레코드를 편집할 수 있나요? | 진실 |
| DataSourceInfo(아이스크림, DataSourceInfo.CreatePermission) | 현재 사용자가 IceCream 데이터 원본에 레코드를 생성할 수 있나요? | 거짓 |
| DataSourceInfo(아이스크림, DataSourceInfo.삭제권한) | 현재 사용자가 IceCream 데이터 원본의 레코드를 삭제할 수 있나요? | 거짓 |