HTTPRequest 노드

HTTPRequest 노드를 사용하여 웹 서비스와 상호작용하십시오.

HTTPRequest 노드는 다음 조작 모드에서 사용 가능합니다.

개발자
Application Integration Suite
표준
고급
고속
배율
어댑터

자세한 정보는 동작 모드의 내용을 참조하십시오.

이 토픽에는 다음 절이 들어 있습니다.

목적

HTTPRequest 노드는 해당 서비스로 전송되는 요청으로 입력 메시지의 일부 또는 전부를 사용하여 웹 서비스와 상호작용합니다. 메시지를 메시지 플로우에서 후속 노드에 전파하기 전에 웹 서비스 응답의 컨텐츠로 보강하여, 입력 메시지의 컨텐츠에서 출력 메시지를 작성하기 위해 노드를 구성할 수도 있습니다.

구성에 따라, 이 노드는 입력 메시지의 지정된 컨텐츠로부터 HTTP 또는 HTTPS(HTTP/SSL) 요청을 구성하고 이 요청을 웹 서비스에 보냅니다. 노드는 웹 서비스로부터 응답을 받고, 출력 트리에서 포함하기 위해 응답을 구문 분석합니다. 노드는 구성에 필요한 경우 HTTP 헤더를 생성합니다.

HTTPInput 또는 HTTPReply 노드를 포함하거나 포함하지 않는 메시지 플로우에서 이 노드를 사용할 수 있습니다.

HTTPRequest 노드는 다음 메시지 도메인의 메시지를 처리합니다.

DFDL
XMLNSC
JSON
BLOB
MIME
XMLNS
MRM

HTTPRequest 노드는 팔레트의 비밀로 하다 드로어에 포함되어 있으며 다음 아이콘으로 IBM® 통합 툴킷 에 표시됩니다.

HTTPRequest 노드를 사용하여 웹 서비스에 대한 요청 발행

HTTP 요청에는 두 개의 부분이 있습니다.

서비스의 URL입니다.
원격 서버가 처리한 다음에 응답을 다시 전송하는 데이터의 스트림으로, 종종 SOAP 또는 XML로 된 기타 웹 서비스 메시지입니다.

URL의 형식은 http://<address>[:<port>]/<function>입니다. 예를 들어, http://localhost:7080/request입니다. 이 URL은 메시지 자체의 필드 또는 로컬 환경의 필드로 HTTPRequest 노드 매개변수에 정적으로 지정할 수 있습니다. 웹 서비스로 전송될 데이터는 HTTPRequest 노드 특성에 지정된 대로 전체 또는 메시지 트리의 일부가 될 수 있습니다.

대부분 요청에서 데이터는 CCSID 1208 형식이어야 합니다. 응답은 입력 메시지를 대체하거나 메시지 트리에 삽입할 수 있습니다. 위치는 HTTPRequest 노드 매개변수에 지정됩니다. 응답의 도메인은 XMLNS입니다. 요청에 성공적이면 HTTPResponse는 메시지 트리의 앞에 삽입되고, 응답은 트리에서 지정된 위치에 배치되고, 요청은 Out 터미널로 전파됩니다. HTTPRequest 노드가 요청을 실행할 수 없는 경우, ExceptionList가 메시지 트리에 삽입되고 트리가 장애 터미널로 전파됩니다.

요청이 HTTPRequest 노드에 의해 성공적으로 전송되지만 웹 서비스가 성공적이지 않은 경우, HTTPResponse가 메시지 트리에 삽입되고 오류 터미널로 전파됩니다. HTTPRequest 노드의 오류 메시지 위치 매개변수는 트리에서 응답이 배치되는 위치 (예: OutputRoot.XMLNS.에러) 를 지정합니다. 계산 노드를 사용하여 이 응답을 적절한 코드 페이지에 캐스트하여 데이터를 표시할 수 있습니다. 예를 들어, 다음과 같습니다.

Set OutputRoot.XMLNS.error850 = CAST(InputRoot.XMLNS.error.BLOB as CHAR CCSID 850);

HTTP에 대한 정보는 하이퍼텍스트 전송 프로토콜- HTTP/1.1의 내용을 참조하십시오. HTTP 리턴 코드에 대한 자세한 정보는 HTTP 응답 코드의 내용을 참조하십시오.

요청이 지정된 기간보다 오래 걸리는 경우 요청이 적합한 메시지와 함께 Failure 터미널로 전파될 수 있도록 제한시간 간격을 지정할 수 있습니다. HTTPRequest 노드가 처리하는 각 요청에 대해 연결을 열고 응답이 리턴될 때 닫습니다. 제한시간 간격이 지정되면 소켓은 간격 후에 닫힙니다. 이렇게 닫히면 요청은 올바른 응답만 가져오고 제한시간을 초과한 요청의 응답 데이터를 제거합니다.

HTTP 프록시를 사용하여 요청을 중간 사이트를 통해 라우트할 수 있습니다. 요청과 응답을 보기 위해 도구를 프록시로서 실행할 수 있으므로 플로우를 디버깅할 수 있습니다. HTTP 목적지는 프록시에 표시됩니다. localhost의 HTTP 목적지를 지정하고 HTTP 프록시가 다른 컴퓨터에서 실행 중인 경우에는, 요청은 원본 요청이 발행된 컴퓨터에서가 아니라 리모트 프록시 컴퓨터로 라우팅됩니다.

메시지 플로우에서 HTTPRequest 노드 사용

HTTPRequest 노드는 HTTP 요청을 전송해야 하는 모든 메시지 플로우에서 사용할 수 있습니다. 가장 일반적인 예는 웹 서비스를 호출하는 메시지 플로우입니다.

웹 서비스에 대한 자세한 정보는 웹 서비스 메시지 처리하기의 내용을 참조하십시오.

HTTPRequest 노드는 다음 인증 메커니즘이 필요한 서비스를 이용할 수 있습니다.

기본 인증 ( HTTP 요청에 신임 정보 제공하기참조)
(윈도우 전용) 통합 Windows 인증 (NTLM, SPNEGO 또는 Kerberos) ( IWA를 사용하여 아웃바운드 요청에 대한 신임 정보 제공하기참조)

오류 핸들링

노드는 TCP/IP를 사용하여 외부 서비스와 직접 상호작용합니다. 그러므로 다음 오류 유형을 경험할 수 있습니다.

TCP/IP 에서 생성되는 오류 (예:no route to host또는connection refused.
노드가 이러한 오류를 감지하면 예외를 생성하고, 예외 목록을 수신한 오류 정보로 채우고, 변경되지 않은 입력 메시지를 Failure 터미널로 라우팅합니다.
웹 서버가 리턴하는 오류. 이러한 오류는 100 - 299 범위 밖에 있는 HTTP 상태 코드로 표시됩니다. 노드가 이러한 오류를 감지하면 오류 탭에 지정된 특성을 따르는 동안 응답을 Error 터미널로 라우팅합니다.
노드는 응답이 어떤 형식일지를 판별할 수 없으므로 응답은 BLOB 메시지로서 생성됩니다. 방향 변경(redirection)을 처리하도록 이 노드를 구성하지 않은 경우에는 방향 변경 상태 코드(3xx)가 있는 메시지도 같은 방법으로 처리됩니다.

HTTP 응답 코드

HTTPRequest 노드는 100시리즈 상태 코드를 '계속' 응답으로 처리하고 현재 응답을 버리고 웹 서버에서 다른 응답을 대기합니다.

200 시리즈 상태 코드는 성공으로 취급되고, 노드에서 다양한 탭의 설정이 생성되는 출력 메시지의 형식을 결정하고, 응답은 노드의 Out 터미널로 라우팅됩니다.

300 시리즈 상태 코드는 경로 재지정에 대한 것입니다. HTTP(s) 방향 변경 수행 특성이 선택된 경우에는 노드는 요청을 수신된 응답에 지정된 새 목적지로 다시 전송합니다. HTTP (s) 리디렉션 따라가기 특성을 선택하지 않은 경우 웹 서비스에 대한 요청을 발행하기 위해 HTTPRequest 노드 사용하기에 설명된 대로 코드가 오류로 처리됩니다. HTTP 리턴 코드에 대한 자세한 정보는 HTTP 응답 코드의 내용을 참조하십시오.

400및 500시리즈 상태 코드는 오류이며 웹 서비스에 대한 요청을 발행하기 위해 HTTPRequest 노드 사용하기에 설명된 대로 처리됩니다. HTTP 리턴 코드에 대한 자세한 정보는 HTTP 응답 코드의 내용을 참조하십시오.

헤더 조작

입력 메시지를 웹 서비스 응답으로 바꾸기 또는 입력을 오류로 바꾸기를 선택하면 입력 메시지의 헤더 (메시지가 HTTPRequest 노드의 In 터미널에 도달할 때 메시지에 속하는 헤더) 가 HTTPRequest 노드를 떠나는 메시지와 함께 전파되지 않습니다. 그러나 메시지 트리에서 위치를 지정하는 특성 중 하나가 지정된 경우 입력 메시지 헤더가 전파됩니다.

원격 웹 서비스가 리턴하는 헤더를 포함한 HTTPResponse 헤더는 노드로부터 전파되는 메시지의 첫 번째 헤더입니다(Properties 다음에). 이 조치는 선택되는 옵션과 상관 없이 수행됩니다. Therefore, for the reply from the HTTPRequest node to be put to a WebSphere® MQ queue, manipulate the headers so that an MQMD is the first header (after Properties).

입력 메시지를 응답으로 대체하는 경우 HTTPRequest 노드 이전에 입력 메시지 MQMD를 환경 트리로 복사한 후 HTTPRequest 노드 다음에 메시지 트리로 다시 복사할 수 있습니다. 응답 위치를 지정할 경우, 기존 입력 메시지 헤더를 유지보수하려면 MQMD가 첫 번째 헤더가 되도록 HTTP 응답 헤더를 이동하거나 제거해야 합니다.

다음 예는 HTTPHeader를 제거하는 ESQL을 포함합니다.

SET OutputRoot = InputRoot;
SET OutputRoot.HTTPResponseHeader = NULL;

다음 예에는 HTTPHeader를 이동하기 위한 ESQL을 포함하므로 제공하는 정보를 유지할 수 있습니다.

SET OutputRoot = InputRoot;
DECLARE HTTPHeaderRef REFERENCE TO OutputRoot.HTTPResponseHeader;
DETACH HTTPHeaderRef;
ATTACH HTTPHeaderRef TO OutputRoot.MQMD AS NEXTSIBLING;

터미널 및 특성

HTTPRequest 노드 터미널은 다음 표에 설명되어 있습니다.

터미널	설명
입력	노드에서 처리할 메시지를 승인하는 입력 터미널입니다.
실패	노드에서 처리하는 중에 실패가 감지될 경우 메시지가 라우팅되는 출력 터미널입니다.
Out	웹 서비스 요청의 정상 완료를 나타내는 경우와 이 메시지 플로우 내에서 추가 처리가 필요한 경우 메시지가 라우팅되는 출력 터미널입니다.
오류	HTTP(s) 방향 변경 수행 특성을 설정하지 않은 경우 방향 변경 코드(3xx)를 포함하여 200-299 범위 밖에 있는 HTTP 상태 코드를 포함하는 메시지가 라우팅되는 출력 터미널입니다.

다음 표에 노드 특성이 설명되어 있습니다. 컬럼 헤드 M은 특성이 필수적인 (기본값이 정의되어 있지 않은 경우 값을 입력해야 하는 경우 패널에서 별표로 표시됨) 인지 여부를 표시합니다. C로 향하는 컬럼은 특성이 구성 가능 인지 여부를 표시합니다 (메시지 플로우를 막대 파일에 추가할 때 값을 변경할 수 있음).

HTTPRequest 노드 설명 특성은 다음 표에 설명되어 있습니다.

특성	M	C	기본값	설명
노드 이름	아니오	아니오	노드 유형, HTTPRequest	노드의 이름입니다.
간단한 설명	아니오	아니오		노드의 간략한 설명입니다.
자세한 설명	아니오	아니오		메시지 플로우에서 노드의 목적을 설명하는 텍스트입니다.

HTTPRequest 노드 기본 특성은 다음 표에 설명되어 있습니다.

특성	M	C	기본값	설명	mqsiapplybaroverride 명령 특성
웹 서비스 URL	예	예		웹 서비스의 URL입니다. http://`hostname`[:`port`]/[`path`] 양식으로 제공해야 합니다. 여기서, http://`hostname`을 지정해야 합니다. `port`에 기본값 80이 있습니다. 값을 지정하는 경우 포트 번호 앞에 콜론(:)을 포함해야 합니다. `path`에는 기본값 /이 있습니다. 값을 지정하는 경우 경로 앞에 /를 포함해야 합니다.	URLSpecifier
요청 제한시간(초)	예	예	120	노드가 웹 서비스로부터 응답을 기다리는 시간(초)입니다. 올바른 범위는 1부터 (2³¹)-1까지입니다. 무제한 대기하는 값은 입력할 수 없습니다. 제한시간은 지정된 값보다 최대 1초까지 길게 걸릴 수 있습니다.	timeoutForServer

HTTPRequest 노드 HTTP 설정 특성은 다음 표에 설명되어 있습니다.

특성	M	C	기본값	설명	mqsiapplybaroverride 명령 특성
HTTP(S) 프록시 위치	아니오	예		요청이 송신되는 프록시 서버입니다. 이 값은 hostname:port 양식이어야 합니다. 구성된 프록시 서버에 인증이 필요한 경우, 자원 이름과 함께 mqsisetdbparms 명령을 사용하여 신임 정보를 설정해야 합니다.`httpproxy`또는 메시지 플로우에서 제공됩니다. 자세한 정보는 인증을 사용할 수 있는 HTTP 프록시 서버를 통한 라우팅 요청의 내용을 참조하십시오.	httpProxyLocation
HTTP(S) 방향 변경 수행	아니오	아니오	선택되지 않음	선택란을 선택하면 경로 재지정을 따릅니다. 선택란을 선택 취소하면 경로 재지정을 따르지 않습니다.
HTTP 버전	아니오	예	1.0	요청에 사용할 HTTP 버전입니다. 올바른 값은 1.0 및 1.1입니다.	httpVersion
HTTP/1.1 활성 유지(keepalive) 사용	아니오	예	선택됨(HTTP 버전이 1.1인 경우)	HTTP/1.1 활성 유지(keepalive)를 사용합니다.	enableKeepAlive
HTTP 메소드	아니오	아니오	POST	HTTP 메소드입니다. 올바른 값은 POST, GET, PUT, DELETE, HEAD입니다. 기본적으로 HTTPRequest 노드는 원격 웹 서버에 연결할 때 HTTP POST 메소드를 사용합니다. HEAD는 서비스가 사용 가능한지 여부를 판별하는 데 사용되고(예를 들어, 어떤 서버가 사용 가능한지를 알아내려고 하는 Network Dispatcher가 사용), 본문 데이터 없이 컨텐츠-길이를 포함하여 올바른 헤더를 다시 전송합니다.
압축 사용	아니오	예	없음	이 특성은 HTTP 요청의 컨텐츠가 압축되는지 여부를 제어합니다. none, gzip, zlib (deflate), deflate에서 값을 선택할 수 있습니다. 요청이 압축되는 경우 컨텐츠 압축을 표시하기 위해 Content-Encoding 헤더가 설정됩니다. zlib(deflate)는 RFC 1950 + RFC 1951 결합을 나타냅니다. deflate는 RFC 1951만을 나타냅니다.	requestCompressionType

주의: The HTTPRequest 또는 HTTPAsyncRequest node always rewrites the Content-Length header, even if you have cleared 입력 또는 요청에서 기본 HTTP 헤더 생성. 이 조치를 통해 컨텐츠는 항상 정확하게 됩니다.

HTTPRequest 노드 SSL 특성은 다음 표에 설명되어 있습니다.

특성	M	C	기본값	설명	mqsiapplybaroverride 명령 특성
프로토콜	아니오	예	TLS	HTTPS 요청 작성 시 사용할 SSL 프로토콜.	프로토콜
허용되는 SSL 비밀번호	아니오	예		SSL 요청 작성 시 사용할 암호 목록입니다(쉼표로 분리). 기본값인 비어 있는 문자열이면 사용 가능한 모든 암호 사용을 의미합니다.	allowedCiphers
SSL 인증서 호스트 이름 검사 사용	아니오	예	아니오	이 특성은 요청을 수신하는 서버의 호스트 이름과 SSL 인증서의 호스트 이름이 일치해야 하는지 여부를 지정합니다.	hostnameChecking
SSL 클라이언트 인증키 알리어스	아니오	예	(빈 문자열)	이 특성은 HTTP 연결의 클라이언트 측의 SSL 인증 알리어스를 지정합니다. 기본값을 사용하는 것은 첫 번째 적절한 키가 자동으로 선택됨을 의미합니다.	keyAlias
인증서 폐기 목록 검사 사용	아니오	예	선택되지 않음	이 특성은 SSL 연결에 대해 CRL 확인을 사용해야 하는지 여부를 지정합니다.	enableCRLCheck

HTTPRequest 노드 응답 메시지 구문 분석 특성은 다음 표에 설명되어 있습니다.

특성	M	C	기본값	설명
메시지 도메인	아니오	아니오	BLOB(blob)	메시지를 구문 분석하는 데 사용되는 도메인입니다. 이 필드가 공백인 경우 기본값은 BLOB입니다.
메시지 모델	아니오	아니오	선택되지 않음	메시지가 정의되는 메시지 모델 스키마 파일의 이름 또는 위치입니다. 찾아보기를 클릭하면 선택한 메시지 도메인에 사용 가능한 메시지 모델 스키마 파일의 목록이 표시됩니다.
메시지	아니오	아니오	선택되지 않음	메시지 모델 스키마 파일 내의 메시지 루트 이름 또는 위치입니다. 이 목록은 사용자가 선택한 메시지 모델에 정의된 모든 사용 가능한 메시지로 채워집니다.
물리적 형식	아니오	아니오	선택되지 않음	메시지의 물리적 형식 이름입니다. MRM 또는 IDOC 구문 분석기를 사용 중인 경우 수신되는 메시지의 물리적 형식을 목록에서 선택하십시오. 이 목록은 선택된 메시지 모델에 정의된 모든 물리적 형식을 포함합니다. 메시지 도메인 특성을 DataObject로 설정한 경우 이 특성을 XML 또는 SAP ALE IDoc로 설정할 수 있습니다. 외부 소스에서 비트스트림을 구문 분석하고 메시지 트리를 생성해야 하는 경우에는 이 특성을 SAP ALE IDoc로 설정하십시오.

HTTPRequest 노드 구문 분석기 옵션 특성은 다음 표에 설명되어 있습니다.

특성	M	C	기본값	설명
구문 분석 타이밍	아니오	아니오	요청 시	이 특성은 응답 메시지를 구문 분석하는 시기를 제어합니다. 올바른 값은 요청 시, 즉시 및 완료입니다. 이 특성에 대한 전체 설명은 요구에 대한 구문 분석의 내용을 참조하십시오.
XML 스키마 데이터 유형을 사용하여 트리 빌드	아니오	아니오	선택되지 않음	이 특성은 XML 스키마에서 가져온 데이터 유형으로 메시지 트리에서 구문 요소를 작성할 것인지 여부를 제어합니다. 유효성 검증 탭의 유효성 검증 특성을 컨텐츠 또는 컨텐츠 및 값으로 설정하는 경우에만 이 특성을 선택할 수 있습니다.
XMLNS 도메인에 대해 XMLNSC 압축 구문 분석기 사용	아니오	아니오	선택되지 않음	이 특성은 XMLNS 도메인의 메시지에 대해 XMLNSC 압축 구문 분석기가 사용되는지 여부를 제어합니다. 이 특성을 설정하면 입력 MQRFH2 헤더 또는 응답 메시지 구문 분석 특성 도메인이 XMLNS일 때 출력 터미널에 연결된 노드의 XMLNSC 아래에 응답 메시지 데이터가 표시됩니다.
혼합 컨텐츠 보유	아니오	아니오	선택되지 않음	이 특성은 XMLNSC 구문 분석기가 응답 메시지에서 혼합 텍스트를 발견하는 경우 메시지 트리에서 요소를 작성하는지 여부를 제어합니다. 선택란을 선택하면 혼합 텍스트에 대한 요소가 작성됩니다. 선택란을 선택 취소하면 혼합 텍스트가 무시되고 요소는 작성되지 않습니다.
주석 보유	아니오	아니오	선택되지 않음	이 특성은 XMLNSC 구문 분석기가 응답 메시지에서 주석을 발견하는 경우 메시지 트리에서 요소를 작성하는지 여부를 제어합니다. 선택란을 선택하면 주석에 따라 요소가 작성됩니다. 선택란을 선택 취소하면 주석이 무시되고 요소는 작성되지 않습니다.
처리 지시사항 보유	아니오	아니오	선택되지 않음	이 특성은 XMLNSC 구문 분석기가 응답 메시지에서 처리 지시사항을 발견하는 경우 메시지 트리에서 요소를 작성하는지 여부를 제어합니다. 선택란을 선택하면 처리 지시사항에 따라 요소가 작성됩니다. 선택란을 선택 취소하면 처리 지시사항이 무시되고 요소는 작성되지 않습니다.
오파크 요소	아니오	아니오	공백	이 특성은 XMLNSC 구문 분석기에 의해 불확실하게 구문 분석되는 요소 목록을 응답 메시지에서 지정하는 데 사용됩니다. 오파크 구문 분석은 유효성 검증이 사용으로 설정되지 않은 경우(즉, 유효성 검증 특성이 없음으로 설정된 경우)에만 수행됩니다. 유효성 검증이 사용으로 설정된 경우 오파크 요소에 지정된 항목은 무시됩니다.

HTTPRequest 노드 오류 처리 특성은 다음 표에 설명되어 있습니다.

특성	M	C	기본값	설명
입력을 오류로 바꾸기	아니오	아니오	선택됨	이 선택란을 선택하면 입력 메시지 컨텐츠가 오류 메시지 컨텐츠로 바뀝니다. 이 선택란을 선택 취소하면 오류 메시지 위치를 지정해야 합니다.
오류 메시지 위치	예	아니오	OutputRoot	웹 서비스 오류 비트스트림에서 구문 분석된 요소가 저장되는 시작 위치입니다. 이 특성은 ESQL 필드 참조 양식을 사용합니다.

HTTPRequest 노드 고급 특성은 다음 표에 설명되어 있습니다.

특성	M	C	기본값	설명	mqsiapplybaroverride 명령 특성
전체 입력 메시지를 요청으로 사용	아니오	아니오	선택됨	이 선택란을 선택하면 전체 입력 메시지 본문이 웹 서비스로 전달됩니다. 이 선택란을 선택 취소하면 트리에서 요청 메시지 위치를 선택해야 합니다.
트리의 요청 메시지 위치	예	아니오	InputRoot	웹 서비스로 보내기 위해 비트스트림이 작성되는 시작 위치입니다. 이 특성은 ESQL 필드 참조 양식을 사용합니다.
입력 메시지를 웹 서비스 응답과 바꾸기	아니오	아니오	선택됨	이 선택란을 선택하면 웹 서비스 응답 메시지는 작성된 출력 메시지의 컨텐츠로 입력 메시지 사본을 바꿉니다. 이 선택란을 선택 취소하면 트리에서 응답 메시지 위치를 선택해야 합니다.
트리의 응답 메시지 위치	예	아니오	OutputRoot	웹 서비스 응답 비트스트림에서 구문 분석된 요소가 저장되는 시작 위치입니다. 이 특성은 ESQL 필드 참조 양식을 사용합니다.
입력으로부터 기본 HTTP 헤더 생성	아니오	아니오	선택됨	이 선택란을 선택하면 HTTPRequestHeader가 생성됩니다. 이 선택란을 선택 취소하면 입력 메시지에 올바른 HTTPRequestHeader가 존재해야 합니다.
기본적으로 압축된 응답 승인	아니오	예	선택되지 않음	이 특성은 기본적으로 요청 노드가 압축된 응답을 처리하는지 여부를 표시합니다. 요청 헤더에 Accept-Encoding 헤더가 없으며, 이 옵션이 선택된 경우 노드는 Accept-Encoding 헤더를 "gzip, deflate"로 설정하고 수신된 모든 압축된 응답을 노드에서 압축 해제합니다. 요청 노드로 전파된 메시지가 Accept-Encoding 헤더를 포함하면, 메시지 플로우 또는 클라이언트 애플리케이션이 압축된 응답을 처리해야 합니다. 따라서 이 옵션을 선택해도 이 경우 적용되지 않습니다.	acceptCompressedResponses

HTTPRequest 노드 유효성 검증 특성은 다음 표에 설명되어 있습니다.

이러한 특성에 대한 전체 설명은 유효성 검증 특성의 내용을 참조하십시오.

특성	M	C	기본값	설명	mqsiapplybaroverride 명령 특성
유효성 검증	아니오	예	NONE	이 특성은 유효성 검증의 수행 여부를 제어합니다. 올바른 값은 없음, 컨텐츠 및 값, 컨텐츠 및 상속입니다.	validateMaster
실패 조치	아니오	아니오	예외	이 특성은 유효성 검증에 실패한 경우 발생하는 상황을 제어합니다. 유효성 검증을 컨텐츠 또는 컨텐츠 및 값으로 설정한 경우에만 이 특성을 설정할 수 있습니다. 올바른 값은 사용자 추적, 로컬 오류 로그, 예외, 예외 목록입니다.

다음 테이블은 노드의 모니터링 특성에 대해 설명합니다.

특성	M	C	기본값	설명
이벤트	아니오	아니오	없음	노드에 대해 정의한 이벤트가 이 탭에 표시됩니다. 기본적으로, 메시지 플로우의 어떤 노드에도 모니터링 이벤트가 정의되지 않습니다. 추가, 편집및 삭제 를 사용하여 노드의 모니터링 이벤트를 작성, 변경 또는 삭제하십시오. 자세한 내용은 모니터링 특성을 사용하여 모니터링 이벤트 소스 구성 의 내용을 참조하십시오. 사용 선택란을 선택하거나 선택 취소해서 여기에 표시되는 이벤트를 사용 및 사용 안함으로 설정할 수 있습니다.

로컬 환경 대체

메시지의 다른 요소에서 값을 설정하는 것과 동일한 방식으로 로컬 환경에서 설정된 값을 동적으로 대체할 수 있습니다. 다음 값은 LocalEnvironment.Destination.HTTP 아래에 설정할 수 있습니다.

설정	설명
RequestURL	노드의 웹 서비스 URL 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.RequestURL = 'http://ibm.com/abc/';`
RequestURLDoNotPercentEncodeCharacters	RequestURL의 문자가 퍼센트 인코딩에서 제외되도록 지정합니다. HTTPRequest 노드의 기본 동작은 요청 URL에서 예약되지 않은 모든 문자를 퍼센트로 인코딩합니다. 예약 문자는 기본적으로 퍼센트 인코딩에서 제외됩니다. 예약 문자는 : / ? # [ ] @ ! $ & ' ( ) * + , ; = < > %입니다.
제한시간	노드에서 요청 제한시간(초) 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.Timeout = 42;`
TimeoutMillis	노드에서 요청 제한시간(초) 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.TimeoutMillis = 5000;` 이 특성은 제한시간을 밀리세컨드 단위로 정의합니다. 두 값이 모두 설정되는 경우 TimeoutMillis의 값이 Timeout의 값을 대체합니다.
ProxyURL	노드의 HTTP(S) 프록시 위치 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.ProxyURL = 'my.proxy';`
RequestLine.RequestURI	를 대체한다.`RequestURI`는 URL과 포트 다음의 경로이다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.RequestLine.RequestURI = '/abc/def';`
RequestLine.HTTPVersion	노드에서 HTTP 버전 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.RequestLine.HTTPVersion = 'HTTP/1.1';`
KeepAlive	노드에서 HTTP/1.1 활성 유지(keepalive) 사용 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.KeepAlive = TRUE;`
RequestLine.Method	노드에서 HTTP 메소드 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.RequestLine.Method = 'GET';`
SSLProtocol	SSLProtocol을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.SSLProtocol = 'TLS';` 올바른 값은 SSL, SSLv3, TLS, TLSv1, TLSv1.1, TLSv1.2, SSL_TLS 및 SSL_TLSv2입니다. 참고: SSLv3 is disabled by default in IBM Integration Bus 버전 10.0, because SSLv3 is no longer considered secure; see SSLv3 을 사용하는 플로우 마이그레이션 for more information.
SSLCiphers	노드에서 허용된 SSL 암호 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.SSLCiphers = 'SSL_RSA_FIPS_WITH_3DES_EDE_CBC_SHA';`
ProxyConnectHeaders	아웃바운드 메시지가 프록시를 통한 SSL 연결인 경우 사용되는 추가 헤더를 지정합니다. 이러한 추가 헤더는 초기 CONNECT 요청과 함께 프록시에 전송됩니다. 예를 들어, SSL을 사용 중일 때 프록시 인증 정보를 프록시 서버로 보낼 수 있습니다. 여러 헤더를 보낼 수 있지만 RFC2616에 따라 각각은 캐리지 리턴과 줄 바꾸기(ASCII 0x0D 0x0A)로 분리되어야 합니다. 예를 들어, `DECLARE CRLF CHAR CAST(X'0D0A' AS CHAR CCSID 1208); SET OutputLocalEnvironment.Destination.HTTP.ProxyConnectHeaders = 'Proxy-Authorization: Basic Zm5lcmJsZTpwYXNzd29yZA==' \|\| CRLF \|\| 'Proxy-Connection: Keep-Alive' \|\| CRLF;` 이 설정은 요청이 프록시 서버를 통한 SSL 요청인 경우에만 사용됩니다. 비SSL 요청에 프록시 인증 정보를 보내려면 다음 예에 표시된 대로 HTTPRequestHeader 폴더에 개별 헤더를 지정하십시오. `SET OutputRoot.HTTPRequestHeader."Proxy-Authorization" = 'Basic Zm5lcmJsZTpwYXNzd29yZA=='; SET OutputRoot.HTTPRequestHeader."Proxy-Connection" = 'Keep-Alive';`
UseFolderMode	를 설정하여`UseFolderMode`. 비트스트림 생성에 사용합니다. 특정 구문 분석기의 경우 이 변경사항은 출력 비트스트림을 변경합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.UseFolderMode = TRUE;`
QueryString	아웃바운드 조회 문자열 매개변수의 설정을 허용합니다. 각 매개변수는 개별적으로 설정되어야 합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.QueryString.param1 = 'my"Value"1'; SET OutputLocalEnvironment.Destination.HTTP.QueryString.param2 = 'my"Value"2';` 위의 ESQL로 인해 다음 조회 문자열이 인코딩되고(http://tools.ietf.org/html/rfc3986에 따라) 아웃바운드 요청과 함께 전송됩니다. `?param1=my%22Value%221&param2= my%22Value%222` 목적지 URL에 이미 하나 이상의 조회 매개변수가 있는 경우, 여기에 지정된 추가 매개변수가 기존 목록에 추가됩니다.
QueryStringCCSID	인코딩하기 전에, 매개변수는 UTF-8인 기본값 이외의 문자 세트로 변환되어야 함을 지정합니다. 결과 문자열이 인코드되기 전에 모든 쿼리 문자열 매개변수가 지정된 CCSID로 변환됩니다 ( RFC3986참조). 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.QueryStringCCSID = 943;` 위의 ESQL은 QueryString 매개변수가 인코딩되기 전에 943 코드 페이지로 변환되는 결과를 낳습니다. 참고: 조회 문자열 매개변수는 유니코드 데이터를 포함해야 합니다.
QueryStringPercentEncodeSpace	QueryString의 공백 문자가 퍼센트 인코딩된 다음에 아웃바운드 요청과 함께 전송됨을 지정합니다. 기본적으로, QueryString의 임의의 공백 문자는 다음과 같이 변환된다.`+`" 문자. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.QueryStringPercentEncodeSpace = TRUE;`
QueryStringSendWithRedirect	QueryString이 HTTP(S) 방향 변경을 사용하여 전송됨을 지정합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.QueryStringSendWithRedirect = TRUE;`
QueryStringDoNotPercentEncodeCharacters	URI가 빌드되는 동안 퍼센트 인코딩되지 않는 QueryString에 있는 문자를 지정합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.QueryStringDoNotPercentEncodeCharacters = 'ch"ar';`
QueryStringSemicolonSeparator	세미콜론 대신 쿼리 문자열 사이의 구분 기호로 사용하도록 지정합니다.`&`" 예를 들어: `SET OutputLocalEnvironment.Destination.HTTP.QueryStringSemicolonSeparator = TRUE;`
압축	노드의 Use compression 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.Compression = 'gzip';` 압축이 적용되는 최소크기(바이트)를 설정하려면 다음 대체를 사용하십시오. `SET OutputLocalEnvironment.Destination.HTTP.MinimumCompressionSize = 1048576;`
SSL 인증 알리어스	노드에서 HTTP 연결의 클라이언트 측에 대해 SSL 인증 알리어스 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.KeyAlias = 'Key1Alias';`
EnableCRLCheck	노드의 인증서 폐기 목록 검사 사용 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.EnableCRLCheck = 'true';`
ServicePrincipalName	통합 노드가 Kerberos 보안 프로토콜을 협상할 때 사용할 SPN(Service Principal Name)을 지정합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.ServicePrincipalName = 'HTTP/iib.iibservice2.com:7800';`
FollowRedirection	노드의 HTTP (S) 방향 수정하기 특성을 대체합니다. 예를 들면, 다음과 같습니다. `SET OutputLocalEnvironment.Destination.HTTP.FollowRedirection = TRUE;`

WrittenDestination 데이터에 대한 작업

요청이 작성된 후에 로컬 환경의 WrittenDestination 폴더는 요청이 전송된 URI 및 압축 세부사항(사용된 경우)으로 업데이트됩니다. HTTPRequest 노드의 WrittenDestination은, 압축이 사용되는 경우에만 표시됩니다.형식입니다.

WrittenDestination = (
   HTTP  = (
      RequestURL = 'http://127.0.0.1:7800/HTTPFLOW' (CHARACTER)
      Compression = (
        OriginalSize = 53 (INTEGER)
        CompressedSize = 71 (INTEGER)
      )
   )
)