핵심 구성 요소를 기반으로 하는 양식에 대해 시각적 규칙 편집기에서 서비스 호출 사용

이는 프리릴리스 기능이고 프리릴리스 채널을 통해 액세스할 수 있습니다.

적응형 양식의 시각적 규칙 편집기는 인스턴스에 대해 구성된 양식 데이터 모델(FDM) 목록에서 서비스를 선택할 수 있는 서비스 호출 기능을 지원합니다. 양식 필드를 서비스의 입력 매개 변수에 직접 매핑할 수 있습니다. 양식 필드를 출력 매개 변수에 매핑하려면 지정된 양식 데이터 모델 서비스에 대해 이벤트 페이로드 옵션을 사용합니다. 또한 시각적 규칙 편집기를 사용하면 출력 응답을 기반으로 서비스 호출 작업의 성공 및 실패 처리기에 대한 규칙을 만들 수 있습니다. 성공 처리기는 서비스 호출 작업의 성공적인 실행을 관리하지만 오류 처리기는 발생하는 모든 오류를 해결합니다.

양식 규칙 편집기에서 서비스 호출 사용의 이점

다음은 광고 양식의 규칙 편집기에서 서비스 호출 작업을 사용할 때의 몇 가지 장점입니다.

성공 및 실패 응답에 대한 서비스 핸들러 호출

시각적 규칙 편집기를 사용하면 출력 응답을 기반으로 서비스 호출 작업의 성공 및 실패 처리기에 대한 규칙을 만들 수 있습니다. 아래 이미지는 적응형 양식에 대한 시각적 규칙 편집기의 서비스 호출 ​을 보여 줍니다.

성공 또는 실패 처리기를 추가하려면 각각 성공 처리기 추가 또는 실패 처리기 추가 ​를 클릭합니다.

성공 처리기 추가 ​를 클릭하면 서비스 성공 처리기 호출 규칙 편집기가 나타나며, 작업이 성공할 때 서비스 호출 출력 응답을 관리할 규칙이나 논리를 지정할 수 있습니다. 조건을 정의하지 않고도 규칙을 지정할 수 있지만 조건 추가 옵션을 클릭하여 성공 처리기에 대한 조건을 추가할 수 있습니다.

서비스 호출 작업에 대한 성공적인 응답을 처리하기 위해 여러 규칙을 추가할 수 있습니다.

{width="50%,"}

마찬가지로 작업이 실패할 경우 서비스 호출 출력 응답을 처리하는 규칙을 추가할 수 있습니다. 아래 그림에는 서비스 오류 처리기 호출 규칙 편집기가 표시됩니다.

서비스 호출 작업에서 실패한 응답을 처리하기 위해 여러 규칙을 추가할 수도 있습니다.

서버에서 오류 유효성 검사 사용 기능을 사용하면 작성자가 서버에서 실행할 적응형 양식을 디자인하는 동안 추가한 유효성 검사를 사용할 수 있습니다.

규칙 편집기에서 서비스 호출을 사용하기 위한 사전 요구 사항

규칙 편집기에서 서비스 호출 ​을 사용하기 전에 충족해야 하는 필수 구성 요소는 다음과 같습니다.

다양한 사용 사례를 통한 서비스 호출 탐색

시각적 규칙 편집기의 서비스 호출 ​을(를) 사용하면 몇 가지 유용한 작업을 수행할 수 있습니다. 이를 사용하여 드롭다운 옵션을 채우고, 반복 가능한 패널 또는 단순 패널을 설정하고, 양식 필드를 확인하는 데 사용할 수 있습니다. 모두 서비스 호출 ​의 출력 응답을 기반으로 합니다. 따라서 양식의 유연성과 상호 작용성을 향상시킵니다.

아래 표에서는 서비스 호출 ​을 사용할 수 있는 몇 가지 시나리오에 대해 설명합니다.

Pet ID 텍스트 상자에 입력한 입력을 기반으로 값을 검색하는 Get Information 양식을 만듭니다. 아래 스크린샷은 이러한 사용 사례에 사용된 양식을 보여 줍니다.

양식 필드

양식에 다음 필드를 추가합니다.

NOTE

양식 필드의 속성 대화 상자에 있는 바인딩 참조 필드에서 을(를) 선택하고 FDM(양식 데이터 모델)에서 추가한 이진 속성을 선택하여 이동합니다.

패널 구성

다음 제약 조건을 사용하여 패널을 반복으로 설정합니다.

요구 사항에 맞게 반복 패널의 값을 조정할 수 있습니다.

데이터 원본

이 예제에서는 Swagger Petstore API를 사용하여 데이터 소스를 구성합니다. 입력한 ID를 기반으로 pet 세부 정보를 검색하는 getPetById 서비스에 대해 양식 데이터 모델이(가) 구성되어 있습니다.

Swagger Petstore API에서 addPet 서비스를 사용하여 다음 JSON을 게시해 보겠습니다.

{
        "id": 101,
        "category": {
            "id": 1,
            "name": "Labrador"
        },
        "name": "Lisa",
        "photoUrls": [
            "https://example.com/photos/lisa1.jpg",
            "https://example.com/photos/lisa2.jpg"
        ],
        "tags": [
            {
                "id": 1,
                "name": "vaccinated"
            },
            {
                "id": 2,
                "name": "friendly"
            },
            {
                "id": 3,
                "name": "house-trained"
            }
        ],
        "status": "available"
    }

규칙과 논리는 Pet ID 텍스트 상자의 규칙 편집기에서 서비스 호출 작업을 사용하여 구현하여 언급된 사용 사례를 보여 줍니다.

이제 각 사용 사례의 구현에 대해 자세히 살펴보겠습니다.

사용 사례 1: 서비스 호출 출력을 사용하여 드롭다운 값 채우기

이 사용 사례에서는 Invoke Service의 출력을 기반으로 드롭다운 옵션을 동적으로 채우는 방법을 보여 줍니다.

구현

이렇게 하려면 Pet ID 텍스트 상자에 규칙을 만들어 getPetById 서비스를 호출하십시오. 규칙에서 성공 처리기 추가 ​에서 photo-url 드롭다운의 enum 속성을 photoUrls(으)로 설정합니다.

출력

Pet ID 텍스트 상자에 101을(를) 입력하여 입력한 값에 따라 드롭다운 옵션을 동적으로 채웁니다.

사용 사례 2: 호출 서비스의 출력을 사용하여 반복 가능한 패널 설정

이 사용 사례에서는 Invoke 서비스 ​의 출력을 기반으로 반복 가능한 패널을 동적으로 채우는 방법을 보여 줍니다.

고려 사항

구현

Pet ID 텍스트 상자에 getPetById 서비스를 호출하는 규칙을 만듭니다. 성공 처리기 추가 ​에서 다른 성공 처리기 응답을 추가합니다. 규칙에서 tags 패널의 값을 tags(으)로 설정합니다.

출력

Pet ID 텍스트 상자에 101을(를) 입력하여 입력 값을 기반으로 반복 가능한 패널을 동적으로 채웁니다.

사용 사례 3: 호출 서비스의 출력을 사용하여 패널 설정

이 사용 사례에서는 서비스 호출 ​의 출력을 기반으로 패널의 값을 동적으로 설정하는 방법을 보여 줍니다.

고려 사항

구현

Pet ID 텍스트 상자에 getPetById 서비스를 호출하는 규칙을 만듭니다. 성공 처리기 추가 ​에서 다른 성공 처리기 응답을 추가합니다. 규칙에서 categoryname 텍스트 상자의 값을 category.name(으)로 설정합니다.

출력

Pet ID 텍스트 상자에 101을(를) 입력하여 입력 값에 따라 패널을 동적으로 채웁니다.

사용 사례 4: 다른 필드의 유효성을 검사하기 위해 서비스 호출의 출력 매개 변수 사용

이 사용 사례에서는 서비스 호출 ​의 출력을 사용하여 다른 양식 필드의 유효성을 동적으로 검사하는 방법을 보여 줍니다.

구현

Pet ID 텍스트 상자에 getPetById 서비스를 호출하는 규칙을 만듭니다. 오류 처리기 추가 ​에서 오류 처리기 응답을 추가합니다. 잘못된 Pet ID을(를) 입력한 경우 제출 단추를 숨깁니다.

출력

Pet ID 텍스트 상자에 102을(를) 입력하면 제출 단추가 숨겨집니다.

자주 묻는 질문

Q: 호출 서비스를 사용하여 규칙을 만든 다음 핵심 구성 요소의 최신 버전으로 업그레이드하면 어떻게 됩니까?

A: 핵심 구성 요소의 최신 버전으로 업그레이드할 때 서비스 호출 규칙은 이전 버전과 호환되므로 최신 사용자 인터페이스로 자동 업데이트됩니다.

Q: 서비스 호출 작업에 대한 성공 또는 실패 응답을 처리하기 위해 여러 규칙을 추가할 수 있습니까?

A: 예, 서비스 호출 작업에 대한 성공 또는 실패 응답을 처리하는 여러 규칙을 추가할 수 있습니다.

관련 문서

추가 리소스