동적 선택 항목에 대한 데이터 수집 동작 생성

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기3분

    • 데이터 수집 동작을 생성하여 동적 선택 입력에 대한 선택 옵션 목록을 생성합니다.

    시작하기 전에

    • 필요한 역할: action_designer 또는 admin
    • REST 엔드포인트에 대한 자격 증명 및 연결 생성
    주:
    동적 입력은 기본 시스템에서 사용할 수 없습니다. 에서 동적 입력을 워크플로우 스튜디오사용하려면 다음을 수행해야 합니다. 요청 Integration Hub 플러그인.

    프로시저

    1. 다음으로 이동 모두 > 프로세스 자동화 > 플로우 디자이너.
    2. 선택 새로 작성 > 작업.
    3. 이름 필드에 작업의 이름을 입력하고, 적절한 애플리케이션 범위를 선택한 다음, 제출을 선택합니다.
    4. 작업 개요에서 입력 아래에 있는 새 단계 추가 아이콘( 새 단계 추가 아이콘 )을선택하고 REST 단계를 선택합니다.
      HTTP 메서드 GET에 적용 가능한 쿼리 매개변수를 사용하여 적절한 기본 URL 및 자원 경로에서 데이터를 가져오도록 REST 단계를 구성합니다. 의 REST 단계 Integration Hub사용에 대한 자세한 내용은 통합 허브의 REST를 참조하십시오REST 단계.
    5. REST 단계 아래의 작업 개요에서 새 단계 추가 아이콘( 새 단계 추가 아이콘)을 선택하고 스크립트 단계를 선택합니다.
      1. Input Variables(입력 변수)에서 Create Variable(변수 생성)을 선택합니다.
        이 입력 변수는 REST 응답 본문을 저장합니다.
        예를 들어 입력 변수 이름에 payload를 입력합니다.
      2. 입력 변수 값에 대해 REST 단계의 응답 본문 출력에 대한 데이터 정제를 선택합니다.
      3. 스크립트에 스크립트를 입력하여 입력 변수로부터 JSON 출력을 생성합니다.
        스크립트에서 이러한 작업을 수행해야 합니다.
        입력 변수를 JSON으로 구문 분석
        API를 JSON - Global 사용하여 입력 변수를 문자열에서 JSON 객체로 변환할 수 있습니다.
        동적 선택 항목에 대해 형식이 지정된 새 JSON 객체 만들기
        응답 값을 선택 목록 옵션에 맵핑하려면 REST 응답의 데이터 구조를 알고 있어야 합니다. 스크립트는 data라는 속성이 있는 동적 선택 JSON 개체를 만들어야 합니다. 데이터 속성 값은 선택 목록 옵션의 배열이어야 합니다. 각 선택 목록 옵션에는 문자열 값으로 설정된 레이블 및 이름 속성이 있어야 합니다. label 속성은 선택 목록에 옵션이 표시되는 방식을 결정합니다. name 속성은 시스템에서 옵션을 저장하고 참조하는 방법을 결정합니다.

        예를 들어 이 JSON 객체는 세 가지 선택 목록 옵션이 있는 배열을 정의합니다.

        {
    data: [
        {
            label: "Choice Option 1",
            name: "choice_option_1"
            
        }, 
        {
            label: "Choice Option 2",
            name: "choice_option_2"
        }, 
        {	
            label: "Choice Option 3",
            name: "choice_option_3"
        }
    ]
}
        주:
        동적 선택 입력은 최대 5,000개의 선택 목록 옵션만 표시할 수 있습니다. 5,000개 이상의 선택 목록 옵션을 반환하는 JSON 객체는 렌더링될 때 잘립니다.
        출력 객체 설정
        동적 선택 JSON 개체를 반환하도록 outputs 개체를 설정합니다.
      4. Output Variables(출력 변수)에서 Create Variable(변수 생성)을 선택합니다.
        이 출력 변수는 스크립트에서 생성하는 선택 목록 옵션을 저장합니다.
      5. 출력 변수 유형으로 JSON을 선택합니다.
        스크립트 출력 변수 유형은 JSON이어야 합니다.
    6. Action Outline(작업 개요)에서 Outputs(출력)를 선택합니다.
      1. Create Output(출력 생성)을 선택합니다.
      2. 출력 레이블 및 이름 출력을 설정합니다.
      3. 출력 유형을 JSON으로 설정합니다.
        주:
        작업에는 여러 출력이 있을 수 있지만 JSON 유형은 하나만 있을 수 있습니다.
      4. 편집 모드 종료를 선택합니다.
      5. 값 필드 옆에 있는 데이터 정제 선택기( 데이터 정제 선택기)를 선택한 다음 선택 목록 옵션을 저장하기 위해 만든 스크립트 단계 출력 변수를 선택합니다.
    7. 저장을 선택하고 작업을 테스트합니다.
      출력의 런타임 값은 데이터 속성과 선택 목록 옵션 배열이 있는 JSON 객체여야 합니다.
      테스트 작업의 출력 예시
    8. 게시를 선택하여 동일한 애플리케이션 범위 내의 다른 플로우 및 작업에서 작업을 사용할 수 있도록 합니다.

    결과

    이제 데이터 수집 작업을 사용하여 상위 작업에서 동적 선택 입력에 대해 표시되는 옵션을 채울 수 있습니다.데이터 수집 작업을 사용하여 동적 선택에 대한 옵션을 채웁니다.