동적 템플릿에 대한 데이터 수집 작업 만들기
데이터 수집 작업을 생성하여 동적 템플릿 입력에 대한 기록 필드 값을 수집합니다.
시작하기 전에
- 필요한 역할: action_designer 또는 admin
- REST 엔드포인트에 대한 자격 증명 및 연결 생성
프로시저
- 다음으로 이동 모두 > 프로세스 자동화 > 플로우 디자이너레이블이 표시됩니다.
- 선택 새로 생성 > 작업레이블이 표시됩니다.
- 작업 이름 필드에 작업 이름을 입력하고, 적절한 애플리케이션 범위를 선택한 다음, 제출을 선택합니다.
- 옵션:
작업 개요에서 입력을 선택합니다.
테이블 이름 또는 동적 URL 경로를 REST 단계에 제공하기 위해 입력을 만들어야 할 수 있습니다.예를 들어, 테이블 이름을 저장할 문자열 입력을 생성합니다. 지침은 필드 이름을 가져오는 데이터 수집 작업 만들기 문서를 참조하십시오.
-
입력 아래의 작업 개요에서 새 단계 추가 아이콘(
)을 선택하고 REST 단계를 선택합니다.
-
연결 상세 정보에서 연결 별칭을 선택하거나 연결 인라인을 정의합니다.
연결 별칭을 사용하면 작업을 편집하지 않고도 연결 상세 정보를 업데이트할 수 있습니다.예를 들어, 로컬 인스턴스에 대한 연결 별칭을 선택합니다.
-
요청 상세 정보에서 요청을 빌드할 메서드를 선택하고, 자원 경로와 HTTP 메서드를 선택한 다음 쿼리 매개변수를 제공합니다.
데이터 수집 작업은 일반적으로 GET HTTP 메서드를 사용하여 REST 엔드포인트에서 데이터를 요청합니다. 의 Integration HubREST 단계 사용에 대한 자세한 내용은 IntegrationHub의 REST를 참조하십시오REST 단계.
-
연결 상세 정보에서 연결 별칭을 선택하거나 연결 인라인을 정의합니다.
-
REST 단계 아래의 작업 개요에서 새 단계 추가 아이콘(
)을 선택하고 스크립트 단계를 선택합니다.
- 입력 변수에서 변수 생성을 선택하고 REST 응답 본문을 저장할 입력 변수를 생성합니다.
- 입력 변수 값의 경우 REST 단계의 응답 본문 출력에 사용할 데이터 정제를 선택합니다.
-
스크립트에 입력 변수에서 JSON 출력을 생성하는 스크립트를 입력합니다.
스크립트에서 이러한 작업을 수행해야 합니다.
- 입력 변수를 JSON으로 구문 분석
- API를 JSON - Global 사용하여 입력 변수를 문자열에서 JSON 객체로 변환할 수 있습니다.
- 동적 템플릿에 대해 형식이 지정된 새 JSON 객체 만들기
- 응답 값을 템플릿 값에 매핑하려면 REST 응답의 데이터 구조를 알고 있어야 합니다. 스크립트는
data라는 속성이 있는 동적 템플릿 JSON 객체를 생성해야 합니다. data 속성의 값은 템플릿 값의 배열이어야 합니다. 각 템플릿 값에는label속성,name속성 및 빈값속성이 있어야 합니다. 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 개체는 렌더링될 때 잘립니다. - outputs 객체 설정
- 동적 템플릿 JSON 개체를 반환하도록 outputs 개체를 설정합니다.
-
Output Variables(출력 변수)에서 Create Variable(변수 생성)을 선택합니다.
이 출력 변수는 스크립트가 생성하는 템플릿 값을 저장합니다.
-
출력 변수 유형으로 JSON을 선택합니다.
스크립트 출력 변수 유형은 JSON이어야 합니다.
-
작업 개요에서 출력을 선택합니다.
- 출력 만들기를 선택합니다.
- 출력 레이블 및 이름 출력을 설정합니다.
-
출력 유형을 JSON으로 설정합니다.
주:작업에는 여러 출력이 있을 수 있지만 JSON 유형은 하나만 있을 수 있습니다.
- 편집 모드 종료를 선택합니다.
-
값 필드 옆에서 데이터 정제 선택기(
)를 선택한 다음 템플릿 값을 저장하기 위해 만든 스크립트 단계 출력 변수를 선택합니다.
-
저장을 클릭하고 작업을 테스트합니다.
실행 세부 정보에서
출력에 대한 런타임 값에 적절한 형식의데이터속성이 포함되어 있으면 데이터 수집 작업이 성공적으로 실행됩니다. - 게시를 클릭하여 동일한 애플리케이션 범위 내의 다른 플로우 또는 작업에서 작업을 사용할 수 있도록 합니다.