스크립트 단계

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

    • 재사용 가능한 작업 내에서 실행할 사용자 지정 JavaScript를 추가합니다. 대부분의 핵심 작업과 단계는 일반적인 사용 사례에 적합하지만 스크립트 단계를 빌드하여 핵심 단계에서 만족하지 않는 동작을 실행할 수 있습니다.

    역할 및 가용성

    작업 단계로 워크플로우 스튜디오 사용할 수 있습니다. action_designer 역할을 가진 사용자는 하나 이상의 작업 단계로 사용자 지정 작업을 생성할 수 있습니다.
    주:
    통합 허브 보다 요청 통합 허브 사용량 및 구독에 대한 통합 허브 정보를 참조하십시오.

    필드

    스크립트 단계에는 JavaScript 데이터를 워크플로우 스튜디오 데이터에 매핑할 수 있는 별도의 입력 및 출력 변수가 포함되어 있습니다. 단계 내에서 입력 및 출력 변수를 정의하여 스크립트 내에서 사용할 수 있는 데이터와 작업의 다른 단계에서 사용할 수 있는 스크립팅 변수를 정의할 워크플로우 스튜디오 수 있습니다.

    필드 설명
    필요한 런타임
    스크립트를 지원하는 데 필요한 런타임 환경입니다. 선택 항목은 다음과 같습니다.
    • 인스턴스: 작업 단계는 인스턴스에서 스크립트를 실행합니다. 스크립트가 API 또는 인스턴스 데이터에 액세스 ServiceNow 해야 하는 경우 이 옵션을 선택합니다. 이는 기본값입니다.
    • MID: 작업 단계는 MID 서버에서 스크립트를 실행합니다. 스크립트가 MID 서버 스크립트 파일 및 API에 액세스해야 하는 경우 이 옵션을 선택합니다. 이 옵션을 선택하면 MID 서버 선택 Using 필드가 표시됩니다.
    • Vanilla(핵심 JavaScript): 작업 단계는 인스턴스 또는 MID 서버에서 스크립트를 실행합니다. 스크립트에 API 또는 인스턴스 데이터가 아닌 ServiceNow 핵심 JavaScript API만 필요한 경우 이 옵션을 선택합니다.

    선택한 런타임에 따라 상황에 맞는 도움말에 표시되는 JavaScript 객체 및 메서드가 결정됩니다.

    주:
    이 필드는 가 활성화된 경우에만 통합 허브 표시됩니다.
    MID 서버 사용함 선택
    사용할 MID 서버 선택 프로세스를 지정합니다. 선택 항목은 다음과 같습니다.
    • 모든 MID입니다. 시스템은 사용 가능한 모든 MID 서버에서 작업 단계를 실행합니다.
    • 연결 별칭을 사용합니다. 시스템은 사용자가 지정하는 연결 별칭을 사용하여 작업을 실행합니다. 이 옵션을 선택하면 연결 별칭 필드가 표시됩니다.
    • 인라인 선택 사용. 시스템은 작업에 지정한 연결 상세 정보를 사용하여 작업을 실행합니다. 이 옵션을 선택하면 호스트, MID 애플리케이션 및 기능 필드가 표시됩니다.
    주:
    이 필드는 가 활성화되고 필수 런타임에서 MID를 선택할 때만 통합 허브 표시됩니다.
    연결 별칭 시스템에서 작업 단계를 실행하는 데 사용하는 연결 및 자격 증명 별칭 기록입니다. flow_designer 또는 관리자 역할을 가진 사용자는 연결된 연결 기록을 만들거나 선택할 수 있습니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명과 연결 정보 프로필을 구성하지 않아도 됩니다. 마찬가지로 연결 정보가 변경되면 사용자 지정 동작을 업데이트할 필요가 없습니다. 연결 및 자격 증명에 대한 자세한 내용은 자격 증명, 연결 및 별칭 섹션을 참조하세요. 연결 유형 Basic의 별칭만 지원됩니다.
    주:
    이 필드는 가 활성화되고 MID 서버 사용에서 연결 별칭 사용을 선택한 경우에만 통합 허브 표시됩니다.
    호스트 시스템에서 작업 단계를 실행하는 MID 서버의 정규화된 도메인 이름입니다. 예: mid-server.domain.com.
    주:
    이 필드는 가 활성화되고 MID 서버 선택 사용에서 인라인 선택 사용을 선택한 경우에만 통합 허브 표시됩니다.
    MID 선택 특정 MID 서버 또는 MID 클러스터를 선택하는 옵션입니다. 다음 옵션 중 하나를 선택합니다.
    • MID 서버 자동 선택: ServiceNow 인스턴스에서 수동 입력 없이 MID MID 서버 서버를 선택합니다.
    • 특정 MID 서버: 인스턴스에서 ServiceNow 지정한 것을 사용합니다 MID 서버 .
    • 특정 MID 클러스터: 인스턴스는 ServiceNow 지정한 MID 클러스터를 사용합니다.

      MID 클러스터는 인스턴스에서 ServiceNow 여러 통합을 처리하고 통합 속도를 개선할 수 있는 MID Server 그룹입니다. 자세한 내용은 Configure a MID Server cluster 문서를 참조하십시오.

    이 필드는 필수 런타임 목록에서 MID 를 선택하고 MID 서버를 사용하여 선택 목록에서 인라인 선택 사용을 선택한 경우에 사용할 수 있습니다.
    MID 클러스터 사용할 MID 클러스터에 대한 데이터 정제입니다. 이 필드는 필수 런타임 목록에서 MID 를 선택하고 MID 서버를 사용하여 선택 목록에서 인라인 선택 사용을 선택한 경우에 사용할 수 있습니다.
    MID 애플리케이션 선택 자격을 얻기 위해 MID 서버 에서 지원해야 하는 애플리케이션을 지정합니다. 시스템은 선택한 애플리케이션을 지원하는 MID 서버에서 작업 단계를 실행합니다.이 필드는 가 활성화되고, MID 선택 목록에서 MID 서버 자동 선택을 선택한 다음, MID 서버 선택 사용에서 인라인 선택 사용을 선택한 경우에만 통합 허브 표시됩니다.
    역량 선택 자격을 갖추기 위해 지원해야 하는 MID 서버 역량입니다. 시스템은 선택한 기능을 지원하는 작업 MID 서버 단계를 실행합니다.이 필드는 가 활성화되고, MID 선택 목록에서 MID 서버 자동 선택을 선택한 다음, MID 서버 선택 사용에서 인라인 선택 사용을 선택한 경우에만 통합 허브 표시됩니다.
    특정 MID 서버 필요한 MID 서버데이터 정제 . 이 필드는 가 활성화되고, MID 선택 목록에서 특정 MID 서버를 선택한 다음, 다음을 사용하여 MID 서버 선택에서 인라인 선택 사용을 선택한 경우에만 통합 허브 표시됩니다.
    입력 변수 작업의 데이터를 나타내는 이름-값 쌍으로, 스크립트 내에서 작업 입력 및 다른 단계의 데이터를 사용할 수 있습니다.
    스크립트
    작업 내에서 실행되는 스크립트입니다. 스크립트의 입력 및 출력 변수에 액세스하려면 전역 객체 입력 및 출력을 사용합니다. 예: inputs.myVariable.
    주:
    스크립트 단계 입력 및 출력 이름에는 다음과 같은 예약된 시스템 이름을 포함할 수 없습니다.
    • sys_id
    • sys_created_by
    • sys_created_on
    • sys_updated_on
    • sys_updated_by
    • sys_mod_count
    일반적으로 시스템 필드와 이름이 같은 변수는 만들지 마십시오. 스크립트 단계에서는 이러한 입력 변수를 필드 이름과 혼동하여 잘못된 값을 사용할 수 있습니다.
    스크립트 단계는 항상 입력 및 출력 전역 객체에 저장된 데이터를 문자열로 변환합니다. 스크립트 단계가 JSON 데이터로 작업해야 하는 경우, 입력 전역 객체를 사용하여 JSON 데이터를 문자열로 변환할 수 있습니다. 또는 JavaScript 변수를 JavaScript 객체가 아닌 문자열로 정의할 수 있습니다. 예를 들어, 이 스크립트는 JSON 데이터를 출력할 수 있는 두 가지 방법을 보여줍니다.
    (function execute(inputs, outputs) {
  outputs.json_object_1 = inputs.json_input;
  var array_of_objs = '[{"name1":"value1"}, {"id":"abcd"}]';
  outputs.json_object_2 = array_of_objs;
})(inputs, outputs);

    기본적으로 워크플로우 스튜디오 인스턴스에서 스크립트를 실행합니다. MID 서버에서 스크립트를 실행하려면 구독이 통합 허브 필요합니다.

    워크플로우 스튜디오 트리거되거나 시작된 도메인에서 스크립트를 실행합니다. 도메인 분리 및 워크플로우 스튜디오 문서를 참조하십시오.

    사용 가능한 클래스 및 메서드는 JavaScript API 상황에 맞는 도움말 또는 API reference.
    출력 변수 JavaScript 출력을 데이터 정제에 매핑합니다 워크플로우 스튜디오 . 작업의 다른 단계에서 스크립트 출력을 사용하려고 할 때 출력 변수를 정의합니다.

    작업 오류 평가

    이 단계가 실패할 경우
    데이터 유형: Choice

    다음 단계를 계속 실행하거나 오류 평가로 이동하는 옵션입니다. 사용자 지정 작업 오류 조건에 단계 상태 코드 또는 메시지를 사용하려면 다음 문서를 참조하십시오 작업 오류 평가.

    예

    이 예제에서는 쉽게 업데이트하거나 변경하고 후속 REST 단계에 추가할 수 있는 JSON 페이로드를 작성합니다.

    주:
    REST 단계 는 기본 시스템에서 사용할 수 없으며 구독이 ServiceNow® 통합 허브 필요합니다.

    작업의 스크립트 단계 예시

    페이로드를 나타내는 출력 변수를 생성하여 [페이로드] 데이터 알약을 REST 단계 본문 필드로 끌 수 있습니다.