클라이언트 API 컨트롤 형식

이 문서에서는 지원되는 컨트롤 형식을 나열합니다. 모든 컨트롤에는 공통 컨트롤 메서드가 있지만 일부 메서드는 다른 값 형식을 사용하고 일부 컨트롤에는 추가 멤버가 있습니다.

제어 유형 Description
주소 복합 주소 입력 필드에 거리, 도시 및 주와 같은 여러 하위 구성 요소를 제공합니다.
Boolean true 또는 false 옵션을 사용하여 라디오 단추 필드를 제공합니다.
DateTime 날짜 및 시간 입력 필드를 제공합니다.
Decimal 10진수 입력 필드를 제공합니다.
Double 부동 소수점 숫자 입력 필드를 제공합니다.
드롭다운 조회 관련 레코드를 선택하기 위한 비모달 드롭다운을 제공합니다.
메일 주소 전자 메일 주소 입력 필드를 제공합니다.
파일 다른 사용자가 편집 가능한 양식의 파일을 선택할 수 있도록 허용합니다.
형식이 지정된 정수 기간, 언어 및 표준 시간대와 같은 값으로 형식이 지정된 정수 필드를 제공합니다.
전체 이름 이름 입력 필드에 이름 및 성 등의 여러 구성 요소를 제공합니다.
Image 다른 사용자가 편집 가능한 양식에 대한 이미지를 선택할 수 있도록 허용합니다.
정수 숫자 정수 입력 필드를 제공합니다.
메모 여러 줄 텍스트 입력 필드를 제공합니다.
모달 조회 관련 레코드를 선택하기 위한 모달 대화 상자를 제공합니다.
돈 통화 입력 필드를 제공합니다.
객관식 확인란 필드를 제공합니다.
다중 선택 선택 목록 여러 옵션을 선택하기 위한 필드를 제공합니다.
선택 목록 드롭다운 및 라디오 단추와 같은 옵션 집합 필드를 제공합니다.
상태 테이블 레코드의 현재 상태를 읽기 전용 값으로 제공합니다.
상태 이유 테이블 레코드의 현재 상태 이유를 읽기 전용 값으로 제공합니다.
String 한 줄 텍스트 입력 필드를 제공합니다.
주식 종목 코드 주식 시세 기호 입력 필드를 제공합니다.
URL URL 입력 필드를 제공합니다.

주소 복합

거리, 도시 및 주와 같은 여러 하위 구성 요소를 포함하는 주소 입력 필드는 주소 복합 컨트롤을 사용합니다.

복합 속성 및 메서드 주소 지정

이러한 멤버를 사용하여 주소 복합 값을 구성하고 읽습니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 setValue 메서드 매개 변수를 참조하세요.
getValue 메서드 동일한 개체를 반환합니다.

setValue 메서드 매개 변수

다음 속성이 있는 개체가 필요합니다.

{
    "line1": "address line one value",
    "line2": "address line two value",
    "line3": "address line three value",
    "city": "address city value",
    "state": "address state value",
    "postalCode": "address postalCode value",
    "country": "address country value"
}

Boolean

true/false 옵션이 있는 라디오 단추 필드는 부울 컨트롤을 사용합니다.

부울 속성 및 메서드

이러한 멤버를 사용하여 부울 필드 값을 설정하고 검색합니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 지역화된 true 또는 false 값에 해당하는 문자열 값이 필요합니다.
getValue 메서드 선택한 옵션 값을 문자열로 반환합니다.

DateTime

날짜 및 시간 입력 필드는 DateTime 컨트롤을 사용합니다.

DateTime 속성 및 메서드

이러한 멤버를 사용하여 날짜 및 시간 값을 관리하고 액세스합니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
isDisabled 재산 필드가 비활성화되어 있으면 반환하고, 그렇지 않으면 false반환 true 합니다.
dataType 재산 datetime 필드의 데이터 형식
setValue 메서드 적절한 형식의 datetime 문자열이 필요합니다.
getValue 메서드 datetime 값을 문자열로 반환합니다.

Decimal

10진수 입력 필드는 10진수 컨트롤을 사용합니다.

10진수 속성 및 메서드

이러한 멤버를 사용하여 10진수 입력을 사용합니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 유효한 10진수를 나타내는 문자열이 필요합니다.
getValue 메서드 10진수 값을 문자열로 반환합니다.

Double

부동 소수점 숫자 입력 필드는 Double 컨트롤을 사용합니다.

Double 속성 및 메서드

이러한 멤버를 사용하여 부동 소수점 숫자 값을 처리합니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 유효한 부동 소수점 숫자를 나타내는 문자열이 필요합니다.
getValue 메서드 숫자 값을 문자열로 반환합니다.

모달이 아닌 조회 컨트롤은 드롭다운 조회 컨트롤을 사용합니다.

이러한 멤버를 사용하여 드롭다운 조회 선택과 상호 작용합니다.

회원 Kind Description
isDropdown 재산 항상 사실입니다. 모달 조회와 드롭다운 조회를 구분하려면 이 속성을 사용합니다.
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 선택할 옵션의 ID를 나타내는 문자열 매개 변수가 필요합니다.
getValue 메서드 선택한 옵션에 대한 폼 { id: string, name: string } 의 개체를 반환하거나 옵션이 선택 되지 않은 경우 정의되지 않은 개체를 반환합니다.

전자 메일

전자 메일 입력 필드는 전자 메일 컨트롤을 사용합니다.

전자 메일 속성 및 메서드

이러한 멤버를 사용하여 이메일 주소 값의 유효성을 검사하고 검색합니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 유효한 전자 메일 주소를 나타내는 문자열이 필요합니다.
getValue 메서드 전자 메일 값을 문자열로 반환합니다.

파일

파일 컨트롤을 사용하면 편집 가능한 양식에 대한 파일을 선택할 수 있습니다.

파일 속성 및 메서드

이러한 멤버를 사용하여 파일을 선택, 액세스 및 제거합니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
maxFileSizeInByte 재산 업로드할 수 있는 파일의 최대 크기(바이트)입니다.
setValue 메서드 파일 형식의 개체를 예상하여 다른 사용자가 파일 선택기를 사용하여 선택한 것처럼 설정합니다. 파일이 비어 있거나 초과하면 메서드가 오류를 throw합니다 maxFileSizeInByte.
getValue 메서드 현재 양식 세션 중에 선택하거나 설정한 File 개체를 반환합니다. Dataverse에 이미 저장된 파일은 다운로드하지 않습니다.
removeFile 메서드 집합 파일을 제거합니다.

Dataverse 파일 열에 저장된 파일을 다운로드하려면 이 메서드를downloadFileFromColumn 사용합니다.

형식이 지정된 정수

기간, 언어 및 표준 시간대와 같은 특정 서식 요구 사항이 있는 정수 필드는 형식이 지정된 정수 컨트롤을 사용합니다.

형식이 지정된 정수 속성 및 메서드

이러한 멤버를 사용하여 특수 서식을 사용하여 정수 관리

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 유효한 형식의 정수인 문자열이 필요합니다.
getValue 메서드 형식이 지정된 정수 값을 문자열로 반환합니다.

전체 이름

여러 구성 요소(이름, 성 등)를 포함할 수 있는 이름 입력 필드는 전체 이름 컨트롤을 사용합니다.

전체 이름 메서드

이러한 멤버를 사용하여 전체 이름 구성 요소를 구성하고 읽습니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 다음과 같은 속성을 { "firstName": "first name value", "middleName": "middle name value", "lastName": "last name value" }가진 개체가 필요합니다.
getValue 메서드 동일한 개체를 반환합니다.

이미지

이미지 컨트롤을 사용하면 편집 가능한 양식에 대한 이미지를 선택할 수 있습니다.

이미지 속성 및 메서드

이러한 멤버를 사용하여 이미지를 선택, 액세스 및 제거할 수 있습니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
maxFileSizeInByte 재산 업로드할 수 있는 이미지의 최대 크기(바이트)입니다.
setValue 메서드 파일 형식의 이미지를 예상하여 다른 사용자가 파일 선택기를 사용하여 선택한 것처럼 설정합니다. 파일이 비어 있거나, 초과 maxFileSizeInByte하거나, 이미지 MIME 형식이 없는 경우 메서드가 오류를 throw합니다.
getValue 메서드 현재 양식 세션 중에 선택하거나 설정한 File 개체를 반환합니다. Dataverse에 이미 저장된 이미지는 다운로드하지 않습니다.
removeFile 메서드 집합 이미지를 제거합니다.

Dataverse 이미지 열에 저장된 이미지를 다운로드하려면 이 메서드를downloadFileFromColumn 사용합니다.

정수

숫자 입력 필드는 정수 컨트롤을 사용합니다.

정수 속성 및 메서드

이러한 멤버를 사용하여 정수 필드 값을 설정하고 검색합니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 유효한 정수의 문자열을 예상합니다.
getValue 메서드 정수 값을 문자열로 반환합니다.

메모

여러 줄 텍스트 입력 필드는 메모 컨트롤을 사용합니다.

메모 속성 및 메서드

이러한 멤버를 사용하여 여러 줄 텍스트 입력 콘텐츠를 관리합니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 문자열 값이 필요합니다. 값이 필드의 구성된 최대 길이를 초과하면 메서드가 오류를 throw합니다.
getValue 메서드 메모 텍스트를 문자열로 반환합니다.

모달 조회 필드는 모달 조회 컨트롤을 사용합니다.

이러한 멤버를 사용하여 모달 조회 값을 설정, 가져오기 및 지울 수 있습니다.

회원 Kind Description
isModal 재산 항상 true입니다. 모달 조회와 드롭다운 조회를 구분하려면 이 속성을 사용합니다.
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 { "id": "레코드의 고유 식별자", "name": "레코드의 기본 이름 필드 값", "entityType": "테이블의 엔터티 형식 이름 값" }
getValue 메서드 동일한 개체를 반환합니다.
clearValue 메서드 필드에서 집합 값을 지웁니다.

돈

통화 입력 필드는 Money 컨트롤을 사용합니다.

돈 속성 및 방법

이러한 멤버를 사용하여 통화 금액을 설정하고 검색합니다.

회원 Kind Description
readOnly 재산 true 필드가 읽기 전용 필드이면 그렇지 않습니다 false.
setValue 메서드 유효한 금액을 나타내는 문자열이 필요합니다.
getValue 메서드 는 money 값을 문자열로 반환합니다.

객관식

확인란 필드는 다중 선택 컨트롤을 사용합니다.

다중 선택 방법

이러한 메서드를 사용하여 확인란 상태를 설정하고 읽습니다.

회원 Kind Description
setValue 메서드 부울 값을 예상합니다.
getValue 메서드 는 확인란 상태를 부울로 반환합니다.

다중 선택 선택 목록

다중 선택 옵션 필드는 MultiSelect 선택 목록 컨트롤을 사용합니다.

MultiSelect 선택 목록 메서드

이러한 메서드를 사용하여 선택한 옵션을 설정하고 읽습니다.

회원 Kind Description
setValue 메서드 선택할 옵션 값을 나타내는 숫자 배열을 예상합니다. 값이 사용 가능한 옵션 중 하나가 아닌 경우 오류를 반환합니다.
getValue 메서드 선택한 옵션 값을 숫자 배열로 반환합니다.
setDisabled 메서드 컨트롤이 서버에 잠겨 있으므로 폼이나 필드가 읽기 전용인 경우에는 아무런 효과가 없습니다.

다음 예제에서는 선택한 옵션을 읽고 설정합니다.

Microsoft.PowerPages.onPagesClientApiReady(async function ($pages) {
    let form = $pages.currentPage.forms.getFormById('form_#1');
    let control = form && form.controls.find(c => c.getType() === 'MultiSelectPicklist');

    if (!control) {
        return;
    }

    // Get the selected values.
    let selectedValues = control.getValue(); // For example, [740740000, 740740001]

    // Set the selected values.
    control.setValue([740740000, 740740001]);
});

선택 목록

옵션 집합 필드(드롭다운, 라디오 단추 등)는 선택 목록 컨트롤을 사용합니다.

Picklist 속성 및 메서드

이러한 멤버를 사용하여 옵션 집합 선택을 구성하고 읽습니다.

회원 Kind Description
subType 재산 선택 목록 컨트롤의 하위 형식입니다. 가능한 값은 다음과 같습니다. VerticalRadioButtonHorizontalRadioButtonMultipleChoiceMatrixDropdown
setValue 메서드 선택할 옵션의 값을 나타내는 문자열이 필요합니다.
getValue 메서드 선택한 옵션 값을 문자열로 반환합니다.

상태

엔터티 레코드의 현재 상태는 상태 컨트롤을 사용합니다.

메모

이 컨트롤은 값 설정을 허용하지 않습니다. 값은 읽기 전용입니다.

상태 이유

엔터티 레코드의 현재 상태 이유는 상태 이유 컨트롤을 사용합니다.

메모

이 컨트롤은 값 설정을 허용하지 않습니다. 값은 읽기 전용입니다.

문자열

텍스트 입력 필드는 String 컨트롤을 사용합니다.

문자열 속성 및 메서드

이러한 멤버를 사용하여 한 줄 텍스트 입력 값을 관리합니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 문자열 값이 필요합니다. 값이 필드의 구성된 최대 길이를 초과하면 메서드가 오류를 throw합니다.
getValue 메서드 문자열 값을 반환합니다.

Ticker 기호

주식 시세 기호 입력 필드는 눈금 기호 컨트롤을 사용합니다.

Ticker 기호 속성 및 메서드

이러한 멤버를 사용하여 주식 시세 기호를 설정하고 검색합니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 유효한 시세 기호를 나타내는 문자열이 필요합니다.
getValue 메서드 시세 기호를 문자열로 반환합니다.

URL

URL 입력 필드는 URL 컨트롤을 사용합니다.

URL 속성 및 메서드

이러한 멤버를 사용하여 URL 값의 유효성을 검사하고 검색합니다.

회원 Kind Description
isReadOnly 재산 필드가 읽기 전용이면 반환하고, 그렇지 않으면 false반환 true 합니다.
setValue 메서드 유효한 URL을 나타내는 문자열이 필요합니다.
getValue 메서드 URL 값을 문자열로 반환합니다.
  • 에 마지막으로 업데이트됨