다음을 통해 공유


DataSourceInfo 함수

적용 대상: 캔버스 앱 모델 기반 앱

데이터 원본에 대한 정보를 제공합니다.

개요

데이터 원본은 사용자 환경을 최적화하도록 풍부한 정보를 제공할 수 있습니다.

수준 정보를 사용하여 사용자 입력의 유효성을 검사하고 Patch 함수를 사용하기 전에 사용자에게 즉각적인 피드백을 제공할 수 있습니다. Validate 함수는 이와 동일한 정보를 사용합니다.

예를 들어 데이터 원본 수준의 정보를 사용하여 레코드를 편집하고 생성할 권한이 없는 사용자에 대한 편집새로 만들기 단추를 비활성화하거나 숨길 수 있습니다.

데이터 원본이 제공하는 정보의 양은 전혀 제공하지 않는 경우를 포함하여 다양합니다. 컬렉션 은 정보를 제공하지 않습니다. 정보가 제공되지 않으면 기본값이 사용되거나 공백이 반환됩니다.

노트

현재 DataSourceInfo 이 함수는 Microsoft Lists에서 지원되지 않습니다.

설명

열 정보

데이터 원본의 특정 열에 대한 정보를 가져오는 데 사용할 DataSourceInfo 수 있습니다.

정보 인수 결과 유형 설명
DataSourceInfo. DisplayName 문자열 열의 표시 이름입니다. 표시 이름을 정의하지 않으면 열 이름이 반환됩니다.
DataSourceInfo. MaxLength 번호 열이 보유할 수 있는 최대 문자 수입니다. 문자열이 포함된 열에만 적용됩니다. 최대값을 설정하지 않으면 공백이 반환됩니다.
DataSourceInfo. MaxValue 번호 열이 보유할 수 있는 최대 숫자 값입니다. 숫자가 포함된 열에만 적용됩니다. 최대값을 설정하지 않으면 공백이 반환됩니다.
DataSourceInfo. MinValue 번호 열이 보유할 수 있는 최소 숫자 값입니다. 숫자가 포함된 열에만 적용됩니다. 최소값을 설정하지 않으면 공백이 반환됩니다.
DataSourceInfo. 필수 Boolean 이 열에 값이 필요한가요? 데이터 원본에 설정하지 않으면 false가 반환됩니다.

세 번째 인수는 문자열 형식의 열 이름입니다. 예를 들어 People 컬렉션의 Phone 열은 큰따옴표를 포함하여 "Phone"으로 전달됩니다.

데이터 원본 정보

데이터 원본에 대한 정보를 전체적으로 가져오는 데 사용할 DataSourceInfo 수도 있습니다.

정보 인수 결과 유형 설명
DataSourceInfo. AllowedValues Boolean 이 데이터 원본에 대해 사용자에게 부여할 수 있는 권한 유형은 무엇인가요? 데이터 원본에 설정하지 않으면 공백이 반환됩니다.
DataSourceInfo. CreatePermission Boolean 현재 사용자에게 이 데이터 원본에 레코드를 만들 권한이 있나요? 데이터 원본에 설정하지 않으면 true가 반환됩니다.
DataSourceInfo. DeletePermission Boolean 현재 사용자에게 이 데이터 원본의 레코드를 삭제할 권한이 있나요? 데이터 원본에 설정하지 않으면 true가 반환됩니다.
DataSourceInfo. EditPermission Boolean 현재 사용자에게 이 데이터 원본의 레코드를 편집할 권한이 있나요? 데이터 원본에 설정하지 않으면 true가 반환됩니다.
DataSourceInfo. ReadPermission Boolean 현재 사용자에게 이 데이터 원본의 레코드를 읽을 권한이 있나요? 데이터 원본에 설정하지 않으면 true가 반환됩니다.

노트

DataSourceInfo 는 현재 사용자에게 요청된 권한이 있는지 여부를 확인할 수 없는 경우 true 를 반환합니다. 실제 작업을 수행할 때 서버에서 권한을 다시 확인하고 허용되지 않으면 오류가 표시됩니다. 현재는 Microsoft Dataverse를 DataSourceInfo 사용하는 경우에만 사용 권한을 확인할 수 있습니다.

구문

DataSourceInfo( DataSource, Information [, ColumnName] )

  • DataSource – 필수 항목입니다. 사용할 데이터 원본입니다.
  • 정보 – 필수. 검색할 정보 유형입니다.
  • ColumnName – 선택 사항. 열 수준 정보를 검색할 열 이름입니다. 데이터 원본 레벨에 대한 정보는 ColumnName 인수를 사용할 수 없습니다.

노트

버전 3.24042 이전의 Power Apps에서 열 이름은 큰따옴표를 사용하여 텍스트 문자열로 지정되었으며 데이터 원본에 연결된 경우 논리적 이름이어야 했습니다. 예를 들어 큰따옴표가 있는 논리 이름 "cr43e_name"이 따옴표가 없는 표시 이름 Name 대신 사용되었습니다. 공백이 포함된 열 이름이 포함된 SharePoint 및 Excel 데이터 원본의 경우 각 공백은 "_x0020_"로 지정되었습니다. 예를 들어 "열 이름""Column_x0020_Name"으로 지정되었습니다. 이 버전 이후 모든 앱은 이 문서에 설명된 새로운 구문으로 자동 업데이트되었습니다.

이 섹션의 예제에서는 IceCream이라는 데이터 원본을 사용합니다.

Icecream 예.

데이터 원본에는 다음 정보도 제공됩니다.

  • Quantity의 표시 이름은 "Quantity on Hand"입니다.
  • Flavor의 최대 길이는 30자입니다.
  • Flavor 열은 값을 포함해야 합니다. Quantity 열은 필요하지 않습니다.
  • 최소 Quantity는 0입니다.
  • 최대 Quantity는 100입니다.
  • 현재 사용자는 IceCream 데이터 원본의 레코드를 읽고 편집할 수 있지만 레코드를 생성하거나 삭제할 수는 없습니다.
수식 설명 결과
DataSourceInfo( IceCream, DataSourceInfo. DisplayName, Quantity ) IceCream 데이터 원본의 Quantity 열에 대한 표시 이름을 반환합니다. "손에 수량"
DataSourceInfo( IceCream, DataSourceInfo. MaxLength, Flavor ) IceCream 데이터 원본의 Flavor 열에 대한 문자열의 최대 길이를 반환합니다. 30
DataSourceInfo( IceCream, DataSourceInfo. 필수, Flavor ) IceCream 데이터 원본의 Flavor 열이 필요한가요? 진실
DataSourceInfo( IceCream, DataSourceInfo. 필수, 수량 ) IceCream 데이터 원본의 Quantity 열이 필요한가요? 거짓
DataSourceInfo( IceCream, DataSourceInfo. MaxValue, Quantity ) IceCream 데이터 원본의 Quantity 열에 대한 최대 숫자 값을 반환합니다. 100
DataSourceInfo( IceCream, DataSourceInfo. MinValue, Quantity ) IceCream 데이터 원본의 Quantity 열에 대한 최소 숫자 값을 반환합니다. 0
DataSourceInfo( IceCream, DataSourceInfo. ReadPermission) 현재 사용자가 IceCream 데이터 원본의 레코드를 읽을 수 있나요? 진실
DataSourceInfo( IceCream, DataSourceInfo. EditPermission) 현재 사용자가 IceCream 데이터 원본의 레코드를 편집할 수 있나요? 진실
DataSourceInfo( IceCream, DataSourceInfo. CreatePermission) 현재 사용자가 IceCream 데이터 원본에 레코드를 생성할 수 있나요? 거짓
DataSourceInfo( IceCream, DataSourceInfo. DeletePermission) 현재 사용자가 IceCream 데이터 원본의 레코드를 삭제할 수 있나요? 거짓