PowerApps의 DataSourceInfo 함수DataSourceInfo function in PowerApps

데이터 원본에 대한 정보를 제공합니다.Provides information about a data source.

개요Overview

데이터 원본은 사용자 환경을 최적화하도록 풍부한 정보를 제공할 수 있습니다.Data sources can provide a wealth of information to optimize the user experience.

수준 정보를 사용하여 사용자 입력의 유효성을 검사하고 Patch 함수를 사용하기 전에 사용자에게 즉각적인 피드백을 제공할 수 있습니다.You can use column-level information to validate user input and provide immediate feedback to the user before using the Patch function. Validate 함수는 이와 동일한 정보를 사용합니다.The Validate function uses this same information.

예를 들어 데이터 원본 수준의 정보를 사용하여 레코드를 편집하고 생성할 권한이 없는 사용자에 대한 편집새로 만들기 단추를 비활성화하거나 숨길 수 있습니다.You can use information at the data-source level, for example, to disable or hide Edit and New buttons for users who don't have permissions to edit and create records.

데이터 원본이 제공하는 정보의 양은 전혀 제공하지 않는 경우를 포함하여 다양합니다.Data sources vary in how much information they provide, including not providing any at all. 컬렉션은 정보를 제공하지 않습니다.Collections provide no information. 정보가 제공되지 않으면 기본값이 사용되거나 공백이 반환됩니다.If a piece of information isn't provided, a default is used, or blank is returned.

설명Description

열 정보Column information

DataSourceInfo를 사용하면 데이터 원본의 특정 열에 대한 정보를 얻을 수 있습니다.You can use DataSourceInfo to obtain information about a particular column of a data source:

정보 인수Information Argument 결과 형식Result Type 설명Description
DataSourceInfo.DisplayNameDataSourceInfo.DisplayName 문자열String 열의 표시 이름입니다.Display name for the column. 표시 이름을 정의하지 않으면 열 이름이 반환됩니다.If no display name is defined, returns the column name.
DataSourceInfo.MaxLengthDataSourceInfo.MaxLength 번호Number 열이 보유할 수 있는 최대 문자 수입니다.Maximum number of characters that the column can hold. 문자열이 포함된 열에만 적용됩니다.Applies only to columns that contain strings. 최대값을 설정하지 않으면 공백이 반환됩니다.If a maximum isn't set, returns blank.
DataSourceInfo.MaxValueDataSourceInfo.MaxValue 번호Number 열이 보유할 수 있는 최대 숫자 값입니다.Maximum numeric value that a column can hold. 숫자가 포함된 열에만 적용됩니다.Applies only to columns that contain numbers. 최대값을 설정하지 않으면 공백이 반환됩니다.If a maximum isn't set, returns blank.
DataSourceInfo.MinValueDataSourceInfo.MinValue 번호Number 열이 보유할 수 있는 최소 숫자 값입니다.Minimum numeric value that a column can hold. 숫자가 포함된 열에만 적용됩니다.Applies only to columns that contain numbers. 최소값을 설정하지 않으면 공백이 반환됩니다.If a minimum isn't set, returns blank.
DataSourceInfo.RequiredDataSourceInfo.Required 부울Boolean 이 열에 값이 필요한가요?Is a value required for this column? 데이터 원본에 설정하지 않으면 false가 반환됩니다.If not set by the data source, returns false.

세 번째 인수는 문자열 형식의 열 이름입니다.The third argument is the name of a column as a string. 예를 들어 People 컬렉션의 Phone 열은 큰따옴표를 포함하여 "Phone" 으로 전달됩니다.For example, column Phone in collection People would be passed as "Phone" including the double quotes.

데이터 원본 정보Data-source information

DataSourceInfo를 사용하여 데이터 원본 전체에 대한 정보를 얻을 수도 있습니다.You can also use DataSourceInfo to obtain information about a data source as a whole:

정보 인수Information Argument 결과 형식Result Type 설명Description
DataSourceInfo.AllowedValuesDataSourceInfo.AllowedValues 부울Boolean 이 데이터 원본에 대해 사용자에게 부여할 수 있는 권한 유형은 무엇인가요?What types of permissions can users be granted for this data source? 데이터 원본에 설정하지 않으면 공백이 반환됩니다.If not set by the data source, returns blank.
DataSourceInfo.CreatePermissionDataSourceInfo.CreatePermission 부울Boolean 현재 사용자에게 이 데이터 원본에 레코드를 만들 권한이 있나요?Does the current user have permission to create records in this data source? 데이터 원본에 설정하지 않으면 true가 반환됩니다.If not set by the data source, returns true.
DataSourceInfo.DeletePermissionDataSourceInfo.DeletePermission 부울Boolean 현재 사용자에게 이 데이터 원본의 레코드를 삭제할 권한이 있나요?Does the current user have permission to delete records in this data source? 데이터 원본에 설정하지 않으면 true가 반환됩니다.If not set by the data source, returns true.
DataSourceInfo.EditPermissionDataSourceInfo.EditPermission 부울Boolean 현재 사용자에게 이 데이터 원본의 레코드를 편집할 권한이 있나요?Does the current user have permission to edit records in this data source? 데이터 원본에 설정하지 않으면 true가 반환됩니다.If not set by the data source, returns true.
DataSourceInfo.ReadPermissionDataSourceInfo.ReadPermission 부울Boolean 현재 사용자에게 이 데이터 원본의 레코드를 읽을 권한이 있나요?Does the current user have permission to read records in this data source? 데이터 원본에 설정하지 않으면 true가 반환됩니다.If not set by the data source, returns true.

구문Syntax

DataSourceInfo( DataSource, Information, ColumnName )DataSourceInfo( DataSource, Information, ColumnName )

  • DataSource – 필수 항목입니다.DataSource – Required. 사용할 데이터 원본입니다.The data source to use.

  • Information – 필수 항목입니다.Information – Required. 검색할 정보 유형입니다.The type of information that you want to retrieve.

  • ColumnName – 선택 항목입니다.ColumnName – Optional. 열 수준 정보의 경우 열 이름은 문자열 형식입니다.For column-level information, the column name as a string. Phone 열은 큰따옴표를 포함하여 "Phone" 으로 전달됩니다.Column Phone would be passed as "Phone", including the double quotes. 데이터 원본 레벨에 대한 정보는 ColumnName 인수를 사용할 수 없습니다.For information at the data-source level, the ColumnName argument can't be used.

    참고

    공백이 있는 열 이름이 포함된 SharePoint 및 Excel 데이터 원본의 경우 각 공백을 "_x0020_" 으로 지정합니다.For SharePoint and Excel data sources that contain column names with spaces, specify each space as "_x0020_". 예를 들어, "Column Name""Column_x0020_Name" 으로 지정합니다.For example, specify "Column Name" as "Column_x0020_Name".

Examples

이 섹션의 예제에서는 IceCream이라는 데이터 원본을 사용합니다.The examples in this section use this data source, named IceCream:

데이터 원본에는 다음 정보도 제공됩니다.The data source has also provided this information:

  • Quantity의 표시 이름은 "보유 물량"입니다.The display name for Quantity is "Quantity on Hand".
  • Flavor의 최대 길이는 30자입니다.The maximum length of Flavor is 30 characters.
  • Flavor 열은 값을 포함해야 합니다.The Flavor column must contain a value. Quantity 열은 필요하지 않습니다.The Quantity column isn't required.
  • 최소 Quantity는 0입니다.The minimum Quantity is 0.
  • 최대 Quantity는 100입니다.The maximum Quantity is 100.
  • 현재 사용자는 IceCream 데이터 원본의 레코드를 읽고 편집할 수 있지만 레코드를 생성하거나 삭제할 수는 없습니다.The current user can read and edit the records of the IceCream data source but can't create or delete records.
수식Formula 설명Description 결과Result
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" ) IceCream 데이터 원본의 Quantity 열에 대한 표시 이름을 반환합니다.Returns the display name for the Quantity column of the IceCream data source. "보유 물량""Quantity on Hand"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" )DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) IceCream 데이터 원본의 Flavor 열에 대한 문자열의 최대 길이를 반환합니다.Returns the maximum length of the string for the Flavor column of the IceCream data source. 3030
DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" ) IceCream 데이터 원본의 Flavor 열이 필요한가요?Is the Flavor column of the IceCream data source required? truetrue
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) IceCream 데이터 원본의 Quantity 열이 필요한가요?Is the Quantity column of the IceCream data source required? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) IceCream 데이터 원본의 Quantity 열에 대한 최대 숫자 값을 반환합니다.Returns the maximum numeric value for the Quantity column of the IceCream data source. 100100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) IceCream 데이터 원본의 Quantity 열에 대한 최소 숫자 값을 반환합니다.Returns the minimum numeric value for the Quantity column of the IceCream data source. 00
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission)DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) 현재 사용자가 IceCream 데이터 원본의 레코드를 읽을 수 있나요?Can the current user read records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.EditPermission)DataSourceInfo( IceCream, DataSourceInfo.EditPermission) 현재 사용자가 IceCream 데이터 원본의 레코드를 편집할 수 있나요?Can the current user edit records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission)DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) 현재 사용자가 IceCream 데이터 원본에 레코드를 생성할 수 있나요?Can the current user create records in the IceCream data source? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission)DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) 현재 사용자가 IceCream 데이터 원본의 레코드를 삭제할 수 있나요?Can the current user delete records in the IceCream data source? falsefalse