스크립트 단계

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기6분

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

    역할 및 가용성

    워크플로우 스튜디오 동작 단계로 사용할 수 있습니다. action_designer 역할을 가진 사용자는 하나 이상의 작업 단계로 사용자 지정 작업을 만들 수 있습니다.
    주:
    Integration Hub 보다 요청 Integration Hub 사용 및 구독에 대한 Integration Hub 자세한 내용입니다.

    필드

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

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

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

    주:
    이 필드는 활성화된 경우에만 Integration Hub 표시됩니다.
    MID 서버 사용함 선택
    사용할 MID 서버 선택 프로세스를 지정합니다. 선택 항목은 다음과 같습니다.
    • 모든 MID입니다. 시스템은 사용 가능한 MID 서버에서 작업 단계를 실행합니다.
    • 연결 별칭을 사용합니다. 시스템은 사용자가 지정한 연결 별칭을 사용하여 작업을 실행합니다. 이 옵션을 선택하면 연결 별칭 필드가 표시됩니다.
    • 인라인 선택 사용. 시스템은 작업에 지정한 연결 세부 정보를 사용하여 작업을 실행합니다. 이 옵션을 선택하면 호스트, MID 애플리케이션 및 역량 필드가 표시됩니다.
    주:
    이 필드는 활성화된 경우에만 Integration Hub 표시되며 필요한 런타임에서 MID를 선택합니다.
    연결 별칭 시스템에서 작업 단계를 실행하는 데 사용하는 연결 및 자격 증명 별칭 기록입니다. flow_designer 또는 관리자 역할을 가진 사용자는 연결된 연결 기록을 만들거나 선택할 수 있습니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명과 연결 정보 프로필을 구성하지 않아도 됩니다. 마찬가지로 연결 정보가 변경되면 사용자 지정 작업을 업데이트할 필요가 없습니다. 연결 및 자격 증명에 대한 자세한 내용은 자격 증명, 연결 및 별칭을 참조하세요. 연결 유형 Basic의 별칭만 지원됩니다.
    주:
    이 필드는 활성화된 경우에만 Integration Hub 표시되며, 다음을 사용하여 MID 서버 선택에서 연결 별칭 사용을 선택합니다.
    호스트 시스템에서 작업 단계가 실행되는 MID 서버의 전체 주소 도메인 이름입니다. 예를 들면 mid-server.domain.com 입니다.
    주:
    이 필드는 활성화된 경우에만 Integration Hub 표시되며, 다음을 사용하여 MID 서버 선택에서 인라인 선택 사용을 선택합니다.
    MID 선택 특정 MID 서버 또는 MID 클러스터를 선택하는 옵션입니다.
    • MID 서버 자동 선택: MID 서버를 자동으로 선택합니다.
    • 특정 MID 서버: 선택한 MID 서버를 사용합니다.
    • 특정 MID 클러스터: 선택한 MID 클러스터를 사용합니다.
    이 필드는 필수 런타임 목록에서 MID 를 선택하고 MID 서버 사용 선택 목록에서 인라인 선택 사용을 선택한 경우에 사용할 수 있습니다.
    MID 클러스터 사용할 MID 클러스터에 대한 데이터 정제입니다. 이 필드는 필수 런타임 목록에서 MID 를 선택하고 MID 서버 사용 선택 목록에서 인라인 선택 사용을 선택한 경우에 사용할 수 있습니다.
    MID 애플리케이션 선택 자격을 얻기 위해 MID 서버가 지원해야 하는 애플리케이션을 지정합니다. 시스템은 선택한 애플리케이션을 지원하는 MID 서버에서 작업 단계를 실행합니다.이 필드는 활성화되고, MID 선택 목록에서 MID 서버 자동 선택이 선택되고, MID 서버 사용에서 인라인 선택 사용을 선택할 때만 Integration Hub 표시됩니다.
    역량 선택 자격을 얻기 위해 지원해야 하는 기능입니다 MID 서버 . 시스템은 선택한 기능을 지원하는 작업 MID 서버 단계부터 실행됩니다.이 필드는 활성화되고, MID 선택 목록에서 MID 서버 자동 선택이 선택되고, MID 서버 사용에서 인라인 선택 사용을 선택할 때만 Integration Hub 표시됩니다.
    특정 MID 서버 필요한 MID 서버데이터 정제입니다. 이 필드는 활성화되고, MID 선택 목록에서 특정 MID 서버를 선택하고, MID 서버 사용에서 인라인 선택 사용을 선택하는 경우에만 Integration Hub 표시됩니다.
    입력 변수 작업의 데이터를 나타내는 이름-값 쌍으로, 작업 입력과 스크립트 내 다른 단계의 데이터를 사용할 수 있습니다.
    스크립트
    작업 내에서 실행되는 스크립트입니다. 스크립트의 입력 및 출력 변수에 액세스하려면 전역 객체 inputs 와 output을 사용합니다. 예를 들어 inputs.myVariable입니다.
    주:
    스크립트 단계 입력 및 출력 이름에는 다음과 같은 예약된 시스템 이름이 포함될 수 없습니다.
    • sys_id
    • sys_created_by
    • sys_created_on
    • sys_updated_on
    • sys_updated_by
    • sys_mod_count
    일반적으로 시스템 필드와 이름이 같은 변수는 생성하지 마세요. 스크립트 단계에서 이러한 입력 변수를 필드 이름으로 혼동하여 잘못된 값을 사용할 수 있습니다.
    스크립트 단계는 항상 입력 및 출력 전역 객체에 저장된 데이터를 문자열로 변환합니다. 스크립트 단계에서 JSON 데이터로 작업해야 하는 경우 inputs 전역 객체를 사용하여 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 서버에서 스크립트를 실행하려면 구독이 Integration Hub 필요합니다.

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

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

    작업 오류 평가

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

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

    예

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

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

    예시 스크립트 단계.

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