동적 템플릿에 대한 데이터 수집 작업 만들기

데이터 수집 작업을 생성하여 동적 템플릿 입력에 대한 기록 필드 값을 수집합니다.

시작하기 전에

• 필요한 역할: action_designer 또는 admin
• REST 엔드포인트에 대한 자격 증명 및 연결 생성

주:

동적 입력은 기본 시스템에서 사용할 수 없습니다. 에서 동적 입력을 워크플로우 스튜디오사용하려면 다음을 수행해야 합니다. 요청 Integration Hub 플러그인.

프로시저

1. 다음으로 이동 모두 > 프로세스 자동화 > 플로우 디자이너.
2. 선택 새로 생성 > 작업.
3. 작업 이름 필드에 작업의 이름을 입력하고, 적절한 애플리케이션 범위를 선택한 다음, 제출을 선택합니다.
4. 옵션: Action Outline(작업 개요)에서 Inputs(입력)를 선택합니다.
   REST 단계에 대한 테이블 이름 또는 동적 URL 경로를 제공하기 위해 입력을 만들어야 할 수 있습니다.
   예를 들어 테이블 이름을 저장할 문자열 입력을 만듭니다. 지침은 필드 이름을 가져오는 데이터 수집 작업 생성 문서를 참조하십시오.
5. 입력 아래의 작업 개요에서 새 단계 추가 아이콘( )을 선택하고 REST 단계를 선택합니다.
   1. 연결 상세 정보에서 연결 별칭을 선택하거나 연결 인라인을 정의합니다.
      연결 별칭을 사용하면 작업을 편집하지 않고도 연결 상세 정보를 업데이트할 수 있습니다.
      예를 들어, 로컬 인스턴스에 대한 연결 별칭을 선택합니다.
   2. 요청 상세 정보의 경우 요청을 빌드할 메서드를 선택하고, 리소스 경로를 제공하고, HTTP 메서드를 선택하고, 쿼리 매개 변수를 제공합니다.
      데이터 수집 작업은 일반적으로 GET HTTP 메서드를 사용하여 REST 엔드포인트에서 데이터를 요청합니다. 의 REST 단계 Integration Hub사용에 대한 자세한 내용은 통합 허브의 REST를 참조하십시오REST 단계.
6. REST 단계 아래의 작업 개요에서 새 단계 추가 아이콘( )을 선택하고 스크립트 단계를 선택합니다.
   1. 입력 변수에서 변수 생성을 선택하고 REST 응답 본문을 저장할 입력 변수를 생성합니다.
   2. 입력 변수 값에 대해 REST 단계의 응답 본문 출력에 대한 데이터 정제를 선택합니다.
   3. 스크립트에 스크립트를 입력하여 입력 변수로부터 JSON 출력을 생성합니다.
      스크립트에서 이러한 작업을 수행해야 합니다.

      입력 변수를 JSON으로 구문 분석

      API를 JSON - Global 사용하여 입력 변수를 문자열에서 JSON 객체로 변환할 수 있습니다.

      동적 템플릿에 대해 형식이 지정된 새 JSON 객체 만들기

      응답 값을 템플릿 값에 매핑하려면 REST 응답의 데이터 구조를 알고 있어야 합니다. 스크립트는 data라는 속성이 있는 동적 템플릿 JSON 객체를 만들어야 합니다. data 속성의 값은 템플릿 값의 배열이어야 합니다. 각 템플릿 값에는 label 속성, name 속성 및 빈 value 속성이 있어야 합니다. label 속성은 템플릿 값 옵션이 작업에 나타나는 방식을 결정합니다. name 속성은 템플릿 값 옵션이 시스템에서 저장되고 참조되는 방식을 결정합니다. 작업이 구성될 때 값을 동적으로 설정할 수 있도록 value 속성이 비어 있습니다.

      예를 들어 이 JSON 객체는 인시던트 테이블의 템플릿 값 배열을 정의합니다.

      {
          "data": [
            {
              "name": "parent",
              "label": "Parent",
              "value": ""
            },
            {
              "name": "number",
              "label": "Number",
              "value": ""
            },
            {
              "name": "state",
              "label": "State",
              "value": ""
            },
            {
              "name": "active",
              "label": "Active",
              "value": ""
            },
            {
              "name": "priority",
              "label": "Priority",
              "value": ""
            },
            {
              "name": "caller_id",
              "label": "Caller id",
              "value": ""
            },
            {
              "name": "short_description",
              "label": "Short description",
              "value": ""
            },
            {
              "name": "description",
              "label": "Description",
              "value": ""
            },
            {
              "name": "sys_id",
              "label": "Sys id",
              "value": ""
            },
            {
              "name": "urgency",
              "label": "Urgency",
              "value": ""
            },
            {
              "name": "assigned_to",
              "label": "Assigned to",
              "value": ""
            },
            {
              "name": "severity",
              "label": "Severity",
              "value": ""
            },
            {
              "name": "category",
              "label": "Category",
              "value": ""
            }
          ]
      }

      주:

      동적 템플릿 입력은 필드 템플릿 값을 5,000개까지만 표시할 수 있습니다. 5,000개 이상의 필드 템플릿 값을 반환하는 JSON 객체는 렌더링될 때 잘립니다.

      출력 객체 설정

      동적 템플릿 JSON 객체를 반환하도록 outputs 객체를 설정합니다.

   4. Output Variables(출력 변수)에서 Create Variable(변수 생성)을 선택합니다.
      이 출력 변수는 스크립트에서 생성하는 템플릿 값을 저장합니다.
   5. 출력 변수 유형으로 JSON을 선택합니다.
      스크립트 출력 변수 유형은 JSON이어야 합니다.
7. Action Outline(작업 개요)에서 Outputs(출력)를 선택합니다.
   1. Create Output(출력 생성)을 선택합니다.
   2. 출력 레이블 및 이름 출력을 설정합니다.
   3. 출력 유형을 JSON으로 설정합니다.
      주:

      작업에는 여러 출력이 있을 수 있지만 JSON 유형은 하나만 있을 수 있습니다.
   4. 편집 모드 종료를 선택합니다.
   5. 값 필드 옆에 있는 데이터 정제 선택기()를 선택한 다음 템플릿 값을 저장하기 위해 만든 스크립트 단계 출력 변수를 선택합니다.
8. Save(저장)를 클릭하고 작업을 테스트합니다.
   실행 세부 정보에서 출력 의 런타임 값에 적절한 형식의 data 속성이 포함되어 있으면 데이터 수집 작업이 성공적으로 실행됩니다.
9. 게시를 클릭하여 동일한 애플리케이션 범위 내의 다른 플로우 또는 작업에서 작업을 사용할 수 있도록 합니다.

결과

이제 데이터 수집 작업을 사용하여 상위 작업에서 동적 템플릿 입력에 대해 나타나는 옵션을 채울 수 있습니다.

관련 태스크

• 동적 입력으로 시작하기
• 동적 선택 항목에 대한 데이터 수집 동작 생성
• 동적 입력 유형 입력에 대한 데이터 수집 작업 작성

관련 참조

• 동적 입력 구성 옵션