스크립트 단계

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 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 또는 관리자 역할을 가진 사용자는 연결된 연결 기록을 만들거나 선택할 수 있습니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명과 연결 정보 프로파일을 구성하지 않아도 됩니다. 마찬가지로 연결 정보가 변경되면 사용자 지정 작업을 업데이트할 필요가 없습니다. 연결 및 자격 증명에 대한 자세한 내용은 자격 증명, 연결 및 별칭을 참조하십시오. 연결 유형 기본의 별칭만 지원됩니다.
    주:
    이 필드는 활성화된 경우에만 통합 허브 표시되며, 다음을 사용하여 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 단계 본문 필드로 끌 수 있습니다.