동적 템플릿에 대한 데이터 수집 작업 생성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분

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

    시작하기 전에

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

    프로시저

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

    결과

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