스크립트 단계

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

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

    역할 및 가용성

    작업 디자이너 작업 단계로 사용할 수 있습니다. action_designer 역할을 가진 사용자는 하나 이상의 작업 단계로 사용자 지정 작업을 만들 수 있습니다.
    주:
    Integration Hub 참조 요청 Integration Hub 사용 및 구독에 대한 Integration Hub 자세한 내용을 확인합니다.

    필드

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

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

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

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

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

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

    작업 오류 평가 필드

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

    예

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

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

    동작의 스크립트 단계 예.

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