샘플 포털 웹 API 구성 요소 구현
다음은 포털 웹 API를 사용하여 생성, 검색, 업데이트 및 삭제 작업을 수행하는 코드 구성 요소를 구현하는 예입니다. 구성 요소는 클릭하여 다른 웹 API 작업을 호출할 수 있는 4개의 단추를 렌더링합니다. 웹 API 호출의 결과는 코드 구성 요소의 맨 아래에 있는 HTML div 요소에 주입됩니다.
필수 항목
- 포털 버전은 9.3.10.x 이상이어야 합니다.
- 스타터 포털 패키지는 9.2.2103.x 이상이어야 합니다.
- 포털에 대해 포털 웹 API를 활성화하려면 사이트 설정을 활성화해야 합니다. 웹 API의 사이트 설정
- 테이블 권한을 사용하여 테이블 보안을 구성합니다. 테이블 사용 권한
코드
여기에서 전체 샘플 구성 요소를 다운로드할 수 있습니다.
기본적으로 샘플에서 구성 요소는 웹 API 예제에서 이름 및 수익 필드 생성, 검색, 설정을 수행하도록 구성됩니다.
기본 구성을 테이블이나 열로 변경하려면 다음과 같이 아래 구성 값을 업데이트하십시오.
private static \_entityName = "account";
private static \_requiredAttributeName = "name";
private static \_requiredAttributeValue = "Web API Custom Control (Sample)";
private static \_currencyAttributeName = "revenue";
private static \_currencyAttributeNameFriendlyName = "annual revenue";
createRecord 메서드는 세 개의 단추를 렌더링하여 수익 필드가 다른 값(100, 200, 300)으로 설정된 계정 레코드를 생성할 수 있도록 합니다.
생성 단추 중 하나를 선택하면 단추의 onClick 이벤트 핸들러는 선택한 단추의 값을 확인하고 웹 API 작업을 사용하여 단추의 값으로 설정된 수익 필드로 계정 레코드를 생성합니다. 계정 레코드의 이름 필드는 웹 API 코드 구성 요소(샘플)로 설정됩니다. 임의의 int가 문자열 끝에 추가됩니다. 웹 API 호출의 콜백 메서드는 호출 결과(성공 또는 실패)를 사용자 지정 컨트롤의 결과 div에 삽입합니다.
deleteRecord 메서드는 드롭다운에서 선택한 레코드를 삭제하는 단추를 렌더링합니다. 드롭다운 컨트롤을 사용하면 삭제할 계정 레코드를 선택할 수 있습니다. 드롭다운에서 계정 레코드를 선택하고 레코드 삭제 단추를 선택하면 레코드가 삭제됩니다. 웹 API 호출의 콜백 메서드는 호출 결과(성공 또는 실패)를 사용자 지정 컨트롤의 결과 div에 삽입합니다.
FetchXMLretrieveMultiple 메서드는 코드 구성 요소의 버튼을 렌더링합니다. 이 단추의 onClick 메서드가 호출되면 FetchXML이 생성되어 모든 계정 레코드에 대한 수익 필드의 평균 값을 계산하기 위해 retrieveMultiple 함수로 전달됩니다. 웹 API 호출의 콜백 메서드는 호출 결과(성공 또는 실패)를 사용자 지정 컨트롤의 결과 div에 삽입합니다.
OData retrieveMultiple 메서드는 코드 구성 요소의 단추를 렌더링합니다. 이 단추의 onClick 메서드가 호출되면 OData 문자열이 생성되어 retrieveMultiple 함수로 전달됩니다. 그러면 코드 구성 요소 웹 API(샘플)과 같은 이름 필드가 있는 모든 계정 레코드가 검색됩니다. 이는 이 코드 구성 요소에 의해 생성된 모든 계정 레코드에 대해 적용됩니다.
레코드를 성공적으로 검색하면 코드 구성 요소에는 수익 필드가 100, 200 또는 300으로 설정된 계정 레코드 수를 계산하고 이 수를 코드 구성 요소의 OData 상태 컨테이너 div에 표시하는 논리가 있습니다. 웹 API 호출의 콜백 메서드는 호출 결과(성공 또는 실패)를 사용자 지정 컨트롤의 결과 div에 삽입합니다.