SAP 시스템 연결 URI 만들기
mySAP Business Suite 연결 URI용 Microsoft BizTalk 어댑터에는 어댑터가 SAP 시스템에 대한 연결을 설정하는 데 사용하는 속성이 포함되어 있습니다.
중요
기본적으로 SAP 클라이언트 라이브러리(librfc32u.dll)는 SAP 시스템에 대한 최대 100개의 연결을 지원합니다. 이 연결 수를 초과하면 예외가 throw됩니다. 따라서 SAP 어댑터가 SAP 시스템에서 열려고 하는 연결 수를 제한하도록 MaxConnectionsPerSystem 바인딩 속성을 설정해야 합니다. 또는 CPIC_MAX_CONV 환경 변수를 설정하여 SAP 클라이언트 라이브러리에서 지원하는 연결 수를 늘입니다. CPIC_MAX_CONV 변경하는 경우 변경 내용을 적용하려면 컴퓨터를 다시 시작해야 합니다. SAP 어댑터 바인딩 속성에 대한 자세한 내용은 MySAP Business Suite 바인딩 속성용 BizTalk 어댑터에 대해 읽어보세요.
이 항목에서는 SAP 연결 URI에 대한 정보를 제공하고 다른 프로그래밍 시나리오에서 연결 URI를 지정하는 방법을 설명하는 다른 topics 대한 링크도 제공합니다.
SAP 어댑터에 대한 연결 URI
일반적인 WCF 엔드포인트 주소 URI는 다음과 같이 표시됩니다.
scheme://userinfoparams@hostinfoparams?query_string
엔드포인트 주소 URI에는 다음 구성 요소가 포함됩니다.
scheme은 체계 이름입니다.
userinfoparams는 엔드포인트에서 사용자 인증에 필요한 매개 변수의 이름-값 컬렉션입니다.
hostinfoparams는 호스트에 대한 연결을 설정하는 데 필요한 정보입니다. 예를 들어 경로입니다.
query_string 물음표(?)로 구분된 매개 변수의 선택적 이름-값 컬렉션입니다.
SAP 어댑터가 SAP 시스템에 사용하는 엔드포인트 주소 URI는 SAP 연결 URI를 사용하여 지정됩니다. SAP 어댑터는 다음과 같이 이 연결 URI를 구현합니다.
sap://user=[USER_NAME];passwd=[PASSWORD];Client=[CLIENT];lang=[LANGUAGE];[UseSnc]=[True|False]@connectiontype/conndetail1/conndetail2?GwHost=[GWHOST]?GwServ=[GWSERV]?MsServ=[MSSERV]?Group=[GROUP]?ListenerDest=[LISTENERDEST]?ListenerGwHost=[LISTENERGWHOST]?ListenerGwServ=[LISTENERGWSERV]?ListenerProgramId=[LISTENERPROGRAMID]?RfcSdkTrace=[true/false]?AbapDebug=[true/false]
연결 URI의 구성 요소는 다음 섹션에서 설명합니다.
SAP 연결 URI 체계
SAP 연결 URI에 대한 체계는 "sap"입니다.
SAP 연결 URI의 사용자 정보
SAP 연결 URI의 사용자 정보(userinfoparams)는 사용자 인증, 클라이언트 식별 및 언어 사양에 필요한 매개 변수의 이름-값 컬렉션으로 표시됩니다. 다음 표에서는 이러한 매개 변수에 대해 설명합니다.
| 속성 | Description |
|---|---|
| 사용자 | SAP 시스템의 사용자 이름입니다. 이 값은 대/소문자를 구분합니다. 연결 URI에서 사용자 이름과 암호를 지정하려면 AcceptCredentialsInUri 바인딩 속성을 true 로 설정해야 합니다. 참고: SAP 어댑터는 SAP 시스템에서 연결을 열 때 사용자 이름에 입력하는 값의 대/소문자를 유지합니다. |
| Passwd | SAP 시스템의 사용자에 대한 암호입니다. 이 값은 대/소문자를 구분합니다. 연결 URI에서 사용자 이름과 암호를 지정하려면 AcceptCredentialsInUri 바인딩 속성을 true 로 설정해야 합니다. 참고: SAP 어댑터는 SAP 시스템에서 연결을 열 때 암호에 대해 입력한 값의 대/소문자를 유지합니다. |
| 클라이언트 | SAP 시스템 클라이언트 ID입니다. |
| 언어 | Language: |
| UseSnc | SAP SNC(Secure Network Communications)를 사용할 수 있는지 여부를 지정하는 선택적 매개 변수입니다. 값은 True 또는 False일 수 있습니다. True이면 SNC를 사용할 수 있습니다. 기본값은 False입니다. SNC를 사용하도록 설정하면 SncPartnerName 및 SncLibrary 바인딩 속성도 설정해야 합니다. 자세한 내용은 MySAP Business Suite 바인딩 속성용 BizTalk 어댑터에 대해 읽어보세요. SNC를 사용하도록 설정하고 연결 URI에 자격 증명이 포함된 경우 어댑터는 예외를 throw합니다. 참고: UseSnc 연결 매개 변수는 연결 형식 A 및 B에만 적용됩니다. 서로 다른 연결 형식 및 해당 중요성은 이 항목의 뒷부분에서 자세히 설명합니다. |
참고
SAP 연결 URI에서 클라이언트 및 언어를 지정해야 합니다.
SAP 어댑터는 AcceptCredentialsinUri 바인딩 속성을 표시하므로 연결 URI에서 SAP 시스템 자격 증명을 지정할 수 있는지 여부를 제어할 수 있습니다. 이는 자격 증명이 연결 URI에서 일반 텍스트로 표시되고 이로 인해 내재된 보안 위험이 제기되기 때문입니다. 기본적으로 AcceptCredentialsInUri 바인딩 속성은 false이며 연결 URI에 자격 증명이 지정된 경우 어댑터가 예외를 throw합니다.
연결 URI에서 자격 증명을 지정해야 하는 몇 가지 시나리오가 있습니다. 예를 들어 WCF 서비스 모델 또는 WCF 채널 모델을 사용할 때 SAP 시스템에서 인바운드 작업을 수신합니다. 이러한 시나리오에서는 AcceptCredentialsInUri 속성을 true로 설정할 수 있습니다. 그러나 연결 URI에서 직접 자격 증명을 제공하지 않는 것이 좋습니다. SAP 연결에 대한 자격 증명을 보다 안전하게 제공하는 방법에 대한 자세한 내용은 SAP 애플리케이션 보안을 참조하세요.
중요
UseSnc 매개 변수를 true로 설정하여 SNC(Secure Network Communications)를 사용하도록 설정하면 어댑터가 예외를 throw합니다.
SAP 연결 URI의 호스트 정보
SAP 호스트 정보(hostinfoparams)는 SAP 연결 URI connectiontype/conndetail1/conndetail2의 요소로 표시됩니다. 이러한 매개 변수는 SAP 시스템에 대한 클라이언트 연결에 대한 세부 정보를 지정합니다. SAP 클라이언트 연결에 대한 추가 세부 정보와 SAP RFC 대상에 대한 수신기로 연결을 설정하는 세부 정보는 query_string 지정할 수 있습니다. SAP 어댑터는 SAP 연결 URI에서 다음과 같은 클라이언트 연결 형식을 지원합니다.
A: 연결 URI가 SAP 어댑터가 SAP에 연결하는 애플리케이션 서버를 지정하는 애플리케이션 호스트 기반 연결입니다.
B: 연결 URI가 SAP 어댑터가 SAP에 연결하는 메시지 서버를 지정하는 부하가 분산된 연결입니다.
D: 연결 URI가 SAP에 대한 연결 매개 변수를 포함하는 saprfc.ini 파일의 대상을 지정하는 대상 기반 연결입니다.
다음 표에서는 SAP 연결 URI에서 이러한 연결을 지정하는 방법을 설명합니다.
| 연결 유형 | Conndetail1 | Conndetail2 | Description |
|---|---|---|---|
| A | ASHOST(애플리케이션 서버 호스트) | SYSNR(SAP 시스템 번호) | 애플리케이션 호스트 기반 연결을 지정합니다. 애플리케이션 호스트 기반 연결의 경우 선택적 게이트웨이 호스트 및 게이트웨이 서비스를 query_string 지정할 수 있습니다. |
| b | MSHOST(메시지 서버 호스트) | R3NAME(SAP R3 이름) | 메시지 서버를 통한 부하 분산 연결을 지정합니다. 부하 분산 연결의 경우 선택적 서버 그룹 및 메시지 서비스를 query_string 지정할 수 있습니다. |
| D | DEST(saprfc.ini 파일의 연결 매개 변수를 포함하는 대상) | -- | 대상 기반 연결을 지정합니다. SAP 연결 매개 변수는 saprfc.ini 파일의 지정된 대상에 포함됩니다. 대상에서 A-type 및 B-type 연결만 지정할 수 있습니다. |
참고
saprfc.ini 파일에서 연결 값을 지정하는 경우 파일이 SAP 시스템에서 요구하는 대로 파일에 액세스하는 .exe 같은 폴더에 있는지 확인합니다. 자세한 내용은 SAP 설명서를 참조하세요.
SAP 연결 URI의 쿼리 정보
SAP 연결 URI의 쿼리 정보(query_string)에는 다음을 지정하기 위해 포함할 수 있는 선택적 매개 변수가 포함되어 있습니다.
애플리케이션 호스트 기반 연결(A)에 대한 추가 연결 세부 정보입니다.
부하 분산 연결에 대한 추가 연결 세부 정보(B).
SAP 시스템에서 RFC, TRFC 및 IDocs를 SAP 어댑터로 보낼 수 있는 SAP 시스템에서 RFC 대상을 지정하는 수신기 세부 정보입니다.
SAP SNC(Secure Network Communications)를 사용하도록 설정할지 여부입니다.
디버깅 구성을 지정하는 세부 정보입니다.
쿼리 매개 변수는 선택 사항입니다. 그러나 SAP 어댑터가 RFC 서버 역할을 하려면 수신기 세부 정보를 지정해야 합니다.
다음 표에서는 쿼리 매개 변수에 대해 설명하고 유효한 SAP 연결 형식을 나타냅니다.
| 값 | 유효한 연결 유형 | Description |
|---|---|---|
| GwHost | A | 애플리케이션 호스트 기반 연결에서 선택적 게이트웨이 호스트의 이름을 지정합니다. |
| GwServ | A | 애플리케이션 호스트 기반 연결에서 선택적 게이트웨이 서비스의 이름을 지정합니다. |
| MsServ | b | 부하 분산 연결에서 선택적 메시지 서비스의 이름을 지정합니다. |
| 그룹 | b | 부하 분산 연결에서 애플리케이션 서버의 선택적 그룹을 지정합니다. |
| ListenerDest | (R) | rfc 서버 연결의 saprfc.ini 파일에서 선택적 대상을 지정합니다. 대상은 R 형식 연결을 지정해야 합니다. |
| ListenerGwHost | (R) | rfc 서버 연결에 대한 게이트웨이 호스트를 지정합니다. 이 매개 변수는 선택 사항입니다. 그러나 rfc 서버 연결이 필요하고 LISTENERDEST가 지정되지 않았거나 saprfc.ini 파일의 대상에서 게이트웨이 호스트를 지정하지 않은 경우 LISTENERGWHOST에는 유효한 게이트웨이 호스트가 포함되어야 합니다. |
| ListenerGwServ | (R) | rfc 서버 연결에 대한 게이트웨이 서비스를 지정합니다. 이 매개 변수는 선택 사항입니다. 그러나 rfc 서버 연결이 필요하고 LISTENERDEST가 지정되지 않았거나 saprfc.ini 파일의 대상에서 게이트웨이 서비스를 지정하지 않은 경우 LISTENERGWSERV에는 유효한 게이트웨이 서비스가 포함되어야 합니다. |
| ListenerProgramId | (R) | rfc 서버 연결의 프로그램 ID를 지정합니다. 이 매개 변수는 선택 사항입니다. 그러나 rfc 서버 연결이 필요하고 LISTENERDEST가 지정되지 않았거나 saprfc.ini 파일의 대상에서 게이트웨이 서비스를 지정하지 않은 경우 LISTENERPROGRAMID에는 유효한 게이트웨이 서비스가 포함되어야 합니다. |
| RfcSdkTrace | 모두 | RFC 라이브러리 추적을 사용할 수 있는지 여부를 지정하는 선택적 매개 변수입니다. 값은 True 또는 False일 수 있습니다. True이면 RFC 라이브러리 추적이 사용됩니다. 기본값은 False입니다. RfcSdkTrace 매개 변수에서 사용하도록 설정된 추적 수준은 환경 변수 RFC_TRACE 따라 달라집니다. - RFC_TRACE 없거나 0으로 설정된 경우 최소 추적 수준이 사용하도록 설정됩니다. - 추적 수준을 높이기 위해 RFC_TRACE 1 또는 2로 설정할 수 있습니다. |
| AbapDebug | 모두 | Visual Studio에서 ABAP 디버깅을 사용할 수 있는지 여부를 지정하는 선택적 매개 변수입니다. 값은 True 또는 False일 수 있습니다. True이면 ABAP 디버깅이 사용됩니다. 기본값은 False입니다. AbapDebug가 True이면 SAP GUI가 열립니다. |
| SAPROUTER | 모두 | 방화벽을 통한 연결에 사용되는 경우 SAProuter에 대한 선택적 매개 변수입니다. 이 매개 변수는 /H/hostname/S/portnumber 형식의 호스트 이름 및 서비스 이름/포트 번호 목록입니다. |
쿼리 문자열의 매개 변수는 SAP 매개 변수이며 해당 값은 SAP에서 정의됩니다. 이러한 매개 변수에 대한 자세한 내용은 SAP 설명서를 참조하세요.
다음은 애플리케이션 호스트 기반 연결에 대한 샘플 연결 URI를 보여 줍니다.
sap://Client=800;lang=EN@A/YourSAPHOST/00
어댑터 구성 대화 상자의 연결 URI 속성
어댑터 서비스 BizTalk 프로젝트 추가 기능 사용 또는 어댑터 서비스 추가 참조 Visual Studio 플러그 인을 사용하여 SAP 시스템에 연결하는 경우 어댑터 구성 대화 상자의 URI 속성 탭에서 연결 URI 매개 변수를 설정합니다. 다음 표에서는 URI 속성 시트에 URI 속성 이 표시되는 방법을 보여 줍니다. (URI 속성은 URI 속성 시트에 나타나는 순서대로 그룹별로 나열됩니다.)
| 범주 | URI 속성 | URI 파트 |
|---|---|---|
| 애플리케이션 서버 | 응용 프로그램 서버 호스트 | Conndetail1(호스트 정보 연결 유형 A) |
| 애플리케이션 서버 | 게이트웨이 호스트 | GwHost(쿼리 문자열) |
| 애플리케이션 서버 | 게이트웨이 서비스 | GwServ(쿼리 문자열) |
| 애플리케이션 서버 | 시스템 번호 | Conndetail2(호스트 정보 연결 유형 A) |
| 대상 | 대상 이름 | Conndetail1(호스트 정보 연결 유형 D) |
| 진단 | RFC 추적 | RfcSdkTrace(쿼리 문자열) |
| 진단 | ABAP 디버그 | AbapDebug(쿼리 문자열) |
| 로그인 정보 | 클라이언트 | 클라이언트(userinfoparams) |
| 로그인 정보 | 언어 | 언어(userinfoparams) |
| 메시지 서버 | 애플리케이션 서버 그룹 이름 | 그룹(쿼리 문자열) |
| 메시지 서버 | 메시지 서버 호스트 | Conndetail1(호스트 정보 연결 유형 B) |
| 메시지 서버 | 메시지 서버 서비스 | MsServ(쿼리 문자열) |
| 메시지 서버 | R/3 시스템 이름 | Conndetail2(호스트 정보 연결 유형 B) |
| 기타 | 연결 유형 | 연결 유형(호스트 정보: A, B 또는 D) |
| 기타 | SAP 라우터 | SAPROUTER(쿼리 문자열) |
| RFC 서버 | 대상 이름 | ListenerDest(쿼리 문자열) |
| RFC 서버 | 게이트웨이 호스트 | ListenerGwHost(쿼리 문자열) |
| RFC 서버 | 게이트웨이 서비스 | ListenerGwServ(쿼리 문자열) |
| RFC 서버 | Program ID입니다. | ListenerProgramId(쿼리 문자열) |
| SNC | UseSnc | UseSnc(사용자 정보) |
RFC 서버 연결에 대한 연결 URI를 지정하는 방법입니다.
SAP 어댑터가 RFC 서버 역할을 할 수 있는 엔드포인트 주소를 만들려면 SAP 시스템의 RFC 대상에 해당하는 SAP 프로그램 ID, SAP 게이트웨이 호스트 및 SAP 게이트웨이 서비스를 지정해야 합니다. SAP에서 RFC 대상을 설정하는 방법에 대한 자세한 내용은 RFC, RFC 대상 만들기 및 SAP에서 RFC 보내기를 참조하세요.
다음 두 가지 방법 중 하나로 연결 URI에서 프로그램 ID, 게이트웨이 호스트 및 게이트웨이 서비스를 지정할 수 있습니다.
ListenerGwHost, ListenerGwServ 및 ListenerProgramId 쿼리 매개 변수를 설정하여
R 형식 연결을 지정하는 saprfc.ini 파일의 대상으로 ListenerDest 쿼리 매개 변수를 설정합니다.
참고
saprfc.ini 파일에 연결 값을 지정하는 경우 파일이 SAP 시스템에서 요구하는 대로 파일에 액세스하는 .exe 또는 표준 위치에 있는지 확인합니다. 자세한 내용은 SAP 설명서를 참조하세요.
RFC 서버 연결에 대한 연결 URI를 지정하려면 다음 예제와 같이 쿼리 문자열에 지정된 RFC 대상을 사용하여 일반 클라이언트 연결을 지정합니다.
sap://Client=800;lang=EN@A/YourSAPHOST/00?ListenerGwHost=YourSAPHOST&ListenerGwServ=SAPGW00&ListenerProgramId=MyProgramId
SAP 어댑터는 연결 URI의 userinfoparams 및 hostinfoparams 부분에 포함된 정보를 사용하여 SAP 시스템에서 메타데이터를 검색하고 쿼리 문자열의 수신기 매개 변수에서 제공하는 정보를 사용하여 SAP RFC 대상에서 수신기로 등록합니다.
연결 URI에서 예약 문자 사용
SAP 어댑터는 매개 변수 값에 특수 문자가 있는 연결 URI 지정을 지원하지 않습니다. 연결 매개 변수 값에 특수 문자가 포함된 경우 다음 중 하나를 수행해야 합니다.
어댑터 서비스 참조 플러그 인 추가 또는 어댑터 서비스 추가 기능 사용을 사용하여 Visual Studio에서 URI를 지정하는 경우 이스케이프 문자를 사용하지 않고 URI 속성 탭에서 그대로 지정해야 합니다. URI 구성 필드에서 직접 URI를 지정하고 연결 매개 변수에 예약된 문자가 포함된 경우 적절한 이스케이프 문자를 사용하여 연결 매개 변수를 지정해야 합니다.
BizTalk Server 관리 콘솔에서 송신 또는 수신 포트를 만드는 동안 URI를 지정하고 연결 매개 변수에 예약된 문자가 포함된 경우 적절한 이스케이프 문자를 사용하여 연결 매개 변수를 지정해야 합니다.
연결 URI를 사용하여 SAP 시스템에 연결
SAP 시스템에 대한 연결을 설정하는 방법에 대한 자세한 내용은 다음을 수행합니다.
어댑터 서비스 사용 BizTalk 프로젝트 추가 기능 또는 어댑터 서비스 참조 Visual Studio 플러그 인 추가를 사용합니다. Visual Studio에서 SAP 시스템에 연결을 참조하세요.
BizTalk Server 솔루션에서 송신 포트 또는 수신 포트(위치)를 구성합니다. SAP 어댑터에 대한 물리적 포트 바인딩 수동 구성을 참조하세요.
프로그래밍 솔루션에서 WCF 채널 모델을 사용합니다. SAP를 사용하여 채널 만들기를 참조하세요.
프로그래밍 솔루션에서 WCF 서비스 모델을 사용합니다. SAP 시스템에 대한 클라이언트 바인딩 구성을 참조하세요.
WCF ServiceModel 메타데이터 유틸리티 도구(svcutil.exe)를 사용합니다. mySAP Business Suite용 BizTalk 어댑터와 함께 ServiceModel 메타데이터 유틸리티 도구 사용을 참조하세요.