SOAP 단계

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

    • 작업 디자이너가 외부 시스템에 아웃바운드 SOAP 웹 서비스 요청을 보낼 수 있도록 합니다.

    주:
    SOAP 단계 은 기본 시스템에서 사용할 수 없으며 구독이 ServiceNow® Integration Hub 필요합니다. 필요한 플러그인이 활성화되면 해당 단계가 통합 아래에 표시됩니다.

    역할 및 가용성

    • 워크플로우 스튜디오 동작 단계로 사용할 수 있습니다. action_designer 역할을 가진 사용자는 하나 이상의 작업 단계로 사용자 지정 작업을 만들 수 있습니다.
    • 작업 디자이너는 이러한 웹 서비스 태스크를 수행하기 위해 web_service_admin 역할이 필요합니다.
      • WSDL 선택
      • 새 WSDL 로드
      • WS-보안 정책 선택
    • ServiceNow® MID 서버 WS-Security 정책을 지원하지 않습니다.

    필드

    필드 설명
    연결 상세 정보
    연결 사용할 연결의 유형입니다.
    • 연결 인라인 정의: 동작 단계 내에서 연결 정보를 정의합니다.
    • 연결 별칭 사용: 연결 별칭 테이블을 사용하여 연결 정보를 정의합니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명과 연결 정보 프로필을 구성하지 않아도 됩니다. 마찬가지로 연결 정보가 변경되면 사용자 지정 동작을 업데이트할 필요가 없습니다.

    연결 및 자격 증명에 대한 자세한 내용은 자격 증명, 연결 및 별칭 소개를 참조하세요.
    연결 별칭 시스템에서 작업 단계를 실행하는 데 사용하는 연결 및 자격 증명 별칭 기록입니다. flow_designer 또는 관리자 역할을 가진 사용자는 연결된 연결 기록을 만들거나 선택할 수 있습니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명과 연결 정보 프로필을 구성하지 않아도 됩니다. 마찬가지로 연결 정보가 변경되면 사용자 지정 작업을 업데이트할 필요가 없습니다. 연결 및 자격 증명에 대한 자세한 내용은 자격 증명, 연결 및 별칭을 참조하세요. 자격 증명 값은 데이터 패널에 암호(2단계 암호화) 데이터 알약으로 표시됩니다.
    주:
    이 필드는 연결 목록에서 연결 별칭 사용을 선택한 경우에 사용할 수 있습니다.
    자격 증명 별칭 시스템에서 작업 단계를 실행하는 데 사용하는 자격 증명 별칭입니다. flow_designer 또는 관리자 역할을 가진 사용자는 연결된 연결 기록을 만들거나 선택할 수 있습니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명을 구성하지 않아도 됩니다. 마찬가지로 자격 증명 정보가 변경되면 사용자 지정 작업을 업데이트할 필요가 없습니다. 연결 및 자격 증명에 대한 자세한 내용은 자격 증명, 연결 및 별칭을 참조하세요. 자격 증명 값은 데이터 패널에 암호(2단계 암호화) 데이터 알약으로 표시됩니다.
    주:
    이 필드는 연결 목록에서 연결 인라인 정의를 선택한 경우에 사용할 수 있습니다.
    MID 사용 a MID 서버 를 사용하여 실행하는 옵션입니다 SOAP 단계. MID 선택, MID 애플리케이션 및 역량 필드를 표시하려면 이 확인란을 선택합니다.
    주:
    이 필드는 연결 목록에서 연결 별칭 사용을 선택한 경우에 사용할 수 있습니다.
    엔드포인트 SOAP 요청의 URL 엔드포인트입니다. 연결 별칭 사용을 선택하면 이 필드는 읽기 전용이며 별칭과 연결된 엔드포인트 URL을 표시합니다. 연결 인라인 정의를 선택한 경우 연결에 대한 엔드포인트 URL을 입력합니다.
    테스트 SOAP 단계 SOAP 단계를 테스트하는 버튼입니다. 테스트하려면 SOAP 단계 테스트 단추를 선택합니다. 필요한 입력 값을 입력하고 테스트 실행 버튼을 선택합니다. 테스트가 실행된 후 테스트 창의 테스트 결과 섹션에 단계 출력 또는 오류 메시지가 표시됩니다.
    연결 시간 제한 호스트가 성공적으로 연결되기까지 시스템에서 기다리는 시간(밀리초)입니다. 이 시간 동안 단계가 성공적으로 연결되지 않으면 연결 요청이 시간 초과됩니다. 연결 인라인 정의를 선택한 경우 연결에 대한 시간 제한 값을 입력합니다. 시스템 기본 연결 시간 제한 값을 사용하려면 이 필드를 비워두십시오.
    MID 선택 특정 MID 서버 또는 MID 클러스터를 선택하는 옵션입니다.
    • MID 서버 자동 선택: MID 서버를 자동으로 선택합니다.
    • 특정 MID 서버: 선택한 MID 서버를 사용합니다.
    • 특정 MID 클러스터: 선택한 MID 클러스터를 사용합니다.
    이 필드는 연결 목록에서 연결 인라인 정의를 선택하고 MID 사용을 선택한 경우에 사용할 수 있습니다.
    MID 클러스터 사용할 MID 클러스터에 대한 데이터 정제입니다. 이 필드는 연결 목록에서 연결 인라인 정의를 선택하고 MID 사용을 선택한 다음 MID 선택 목록에서 특정 MID 클러스터 를 선택한 경우에 사용할 수 있습니다.
    요청 상세 정보
    빌드 봉투 SOAP 봉투를 작성할 때 사용할 메서드입니다.
    • WSDL에서: WSDL 및작업 선택 필드를 표시하려면 이 옵션을 선택합니다.
    • 수동으로: WSDL 텍스트를 수동으로 입력하거나 붙여 넣으려면 이 옵션을 선택합니다.
    WSDL 선택 SOAP 봉투를 작성하는 데 사용할 WSDL입니다. 기존 WSDL 레코드를 선택하거나 새 WSDL 로드 를 클릭하여 WSDL 파일을 다운로드하거나 수동으로 입력합니다. 선택한 WSDL이 작업, SOAP 작업 및 SOAP 봉투 필드의 값을 채웁니다.
    주:
    이 필드는 빌드 봉투 목록에서 WSDL에서 를 선택할 때 사용할 수 있습니다.
    새 WSDL 로드 WSDL 파일을 다운로드하거나 수동으로 입력하는 옵션입니다.
    운영 선택한 WSDL에서 실행할 작업입니다. 각 WSDL에는 사용 가능한 조작의 자체 목록이 있습니다.
    SOAP 동작 SOAP 작업을 실행할 URL입니다. 빌드 봉투가 WSDL에서로 설정된 경우 이 필드는 읽기 전용이며 SOAP 작업을 실행할 URL을 표시합니다. 봉투 빌드가 수동으로 설정된 경우 URL을 입력하여 SOAP 작업을 실행합니다.
    요청 유형 요청 형식입니다. 옵션은 다음과 같습니다.
    • 텍스트: JSON, XML 또는 기타 텍스트 형식의 요청입니다.
    • 이진수: 바이너리 파일 형식의 요청입니다.
    SOAP 봉투 엔드포인트로 전송된 XML 텍스트입니다. 빌드 엔벨로프가 WSDL에서로 설정된 경우 선택한 작업에 필요한 XML이 추가됩니다. 봉투 작성이 수동으로 설정된 경우 사용할 XML 텍스트를 입력합니다. 적절한 SOAP 엔벨로프 요소에 레코드 값을 입력합니다. 예를 들어 <short_description> 요소에 인시던트에 대한 짧은 설명을 입력합니다.
    주:
    이 필드는 요청 유형 이 텍스트일 때 사용할 수 있습니다.
    첨부 파일 요청을 포함하는 첨부 파일 기록입니다. 이전 단계에서 이 기록을 조회 또는 생성하고 입력 변수로 정의할 수 있습니다. 스크립트 단계에서 JSONStreamingBuilder 및 XMLStreamingBuilder API를 사용하여 작성하십시오.
    주:
    이 필드는 요청 유형 이 이진일 때 사용할 수 있습니다.
    봉투 재설정 SOAP 봉투에 대한 모든 수동 변경 내용을 취소하는 옵션입니다. SOAP 봉투를 원래 상태로 되돌리려면 이 확인란을 선택합니다.
    주:
    이 필드는 빌드 봉투 목록에서 WSDL에서 를 선택할 때 사용할 수 있습니다.
    새 WSDL
    이름 작성할 WSDL 기록의 이름입니다.
    메서드 임포트 WSDL을 입력하는 메서드입니다.
    • URL에서 다운로드: 외부 소스(일반적으로 웹 서비스 제공자)에서 WSDL을 검색하기 위한 WSDL URL, 사용자 이름 및 암호 필드를 표시하려면 선택합니다.
    • 수동으로 WSDL 컨텐츠 채우기: WSDL 컨텐츠 필드를 표시하려면 선택하여 WSDL 텍스트를 수동으로 입력하거나 붙여 넣습니다.
    WSDL URL SOAP 웹 서비스의 URL입니다.
    주:
    이 필드는 임포트 방법(Import Method) 목록에서 URL에서 다운로드(Download from URL )를 선택한 경우에 사용할 수 있습니다.
    사용자 이름 SOAP 웹 서비스를 사용하여 인증할 사용자 이름입니다.
    주:
    이 필드는 임포트 방법(Import Method) 목록에서 URL에서 다운로드(Download from URL )를 선택한 경우에 사용할 수 있습니다.
    암호 SOAP 웹 서비스를 사용하여 인증하기 위한 암호입니다. 시스템은 항상 사용자 인터페이스에서 암호를 마스킹하고 일반 텍스트로 내보내지 못하게 합니다.
    주:
    이 필드는 임포트 방법(Import Method) 목록에서 URL에서 다운로드(Download from URL )를 선택한 경우에 사용할 수 있습니다.
    WSDL 컨텐츠 SOAP 웹 서비스 및 해당 작업을 설명하는 XML 문서입니다.
    주:
    이 필드는 임포트 방법 목록에서 WSDL 컨텐트 수동으로 채우기를 선택한 경우에 사용할 수 있습니다.
    임포트 인스턴스에 SOAP 웹 서비스 WSDL을 추가하는 옵션입니다.
    WS-Security
    WS-보안 정책 사용 SOAP 웹 서비스를 보안 정책으로 제한하는 옵션입니다. 이 확인란을 선택하여 정책 필드를 표시합니다.
    정책 웹 서비스 연결을 제한하는 데 사용할 정책 기록입니다. 기존 정책 기록을 선택합니다.
    재시도 정책
    재시도 정책 사용 재시도 정책을 활성화하는 옵션입니다. 자세한 내용은 재시도 정책을 참조하십시오.
    별칭에 대한 기본 정책 무효화 기본 재시도 정책을 무효화하는 옵션입니다. 연결 목록에서 연결 인라인 정의를 선택한 경우에는 이 확인란을 적용할 수 없습니다.
    재시도 정책 연결 별칭에 연결된 기본 재시도 정책입니다. 별칭에 대한 기본 정책 무효화를 선택한 경우 기본 재시도 정책을 무효화하고 필요에 따라 다른 기존 재시도 정책을 선택할 수 있습니다.
    고급 옵션
    머리글 SOAP 메시지에 HTTP 헤더로 포함할 이름-값 쌍입니다. 더하기 아이콘 더하기 아이콘을 클릭하여 헤더를 추가합니다. 각 HTTP 헤더에 대한 이름 및 값을 추가합니다.
    헤더 > 비어 있는 경우 생략 값이 비어 있거나 null인 경우 헤더를 제외하는 옵션입니다.
    주:
    이 확인란은 아래쪽 화살표를 클릭하여 고급 옵션을 표시한 후에 사용할 수 있습니다.

    작업 오류 평가

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

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

    SOAP 응답 크기 제한

    시스템은 SOAP 응답의 크기를 5MB로 제한합니다. 이 제한을 초과하는 직접 SOAP 응답은 오류를 생성합니다. 더 큰 응답 크기를 지원하려면 시스템 속성을 사용하여 응답 크기 제한을 늘리십시오 glide.pf.soap.response_payload_max_size . 이 시스템 속성은 최대값 10MB를 지원합니다.