DataSourceInfo 함수

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

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

개요

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

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

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

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

노트

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

설명

열 정보

DataSourceInfo를 사용하면 데이터 원본의 특정 열에 대한 정보를 얻을 수 있습니다.

정보 인수 결과 유형 설명
DataSourceInfo.DisplayName 문자열 열의 표시 이름입니다. 표시 이름을 정의하지 않으면 열 이름이 반환됩니다.
DataSourceInfo.MaxLength 번호 열이 보유할 수 있는 최대 문자 수입니다. 문자열이 포함된 열에만 적용됩니다. 최대값을 설정하지 않으면 공백이 반환됩니다.
DataSourceInfo.MaxValue 번호 열이 보유할 수 있는 최대 숫자 값입니다. 숫자가 포함된 열에만 적용됩니다. 최대값을 설정하지 않으면 공백이 반환됩니다.
DataSourceInfo.MinValue 번호 열이 보유할 수 있는 최소 숫자 값입니다. 숫자가 포함된 열에만 적용됩니다. 최소값을 설정하지 않으면 공백이 반환됩니다.
DataSourceInfo.Required 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를 반환합니다. 실제 작업을 수행할 때 서버에서 권한을 다시 확인하고 허용되지 않으면 오류가 표시됩니다. 이때 DataSourceInfo를 통한 권한 확인은 Microsoft Dataverse를 사용할 때만 가능합니다.

구문

DataSourceInfo( DataSource, Information, ColumnName )

  • DataSource – 필수 항목입니다. 사용할 데이터 원본입니다.

  • Information – 필수 항목입니다. 검색할 정보 유형입니다.

  • ColumnName – 선택 사항입니다. 열 수준 정보의 경우 열 이름은 문자열 형식입니다. Phone 열은 큰따옴표를 포함하여 "Phone"으로 전달됩니다. 데이터 원본 레벨에 대한 정보는 ColumnName 인수를 사용할 수 없습니다.

    노트

    공백이 있는 열 이름을 포함하는 SharePoint 및 Excel 데이터 원본의 경우 각 공백을 "_x0020_"로 지정합니다. 예를 들어, "Column Name""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 열에 대한 표시 이름을 반환합니다. "Quantity on Hand"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) IceCream 데이터 원본의 Flavor 열에 대한 문자열의 최대 길이를 반환합니다. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" ) IceCream 데이터 원본의 Flavor 열이 필요한가요? true
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) IceCream 데이터 원본의 Quantity 열이 필요한가요? false
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) IceCream 데이터 원본의 Quantity 열에 대한 최대 숫자 값을 반환합니다. 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) IceCream 데이터 원본의 Quantity 열에 대한 최소 숫자 값을 반환합니다. 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) 현재 사용자가 IceCream 데이터 원본의 레코드를 읽을 수 있나요? true
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) 현재 사용자가 IceCream 데이터 원본의 레코드를 편집할 수 있나요? true
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) 현재 사용자가 IceCream 데이터 원본에 레코드를 생성할 수 있나요? false
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) 현재 사용자가 IceCream 데이터 원본의 레코드를 삭제할 수 있나요? false