Oracle E-Business Suite 연결 URI 만들기
Microsoft BizTalk Adapter for Oracle E-Business Suite 연결 URI에는 어댑터가 Oracle E-Business Suite에 대한 연결을 설정하는 데 사용하는 속성과 기본적으로 기본 Oracle 데이터베이스가 포함되어 있습니다. Oracle E-Business 어댑터는 tnsnames.ora를 사용하고 tnsnames.ora를 사용하지 않고 기본 Oracle 데이터베이스에 연결하는 두 가지 방법을 지원합니다. 연결 방법의 종류에 따라 연결 URI의 형식도 다릅니다. 이 항목에서는 Oracle 연결 URI에 대한 정보를 제공하고 다른 프로그래밍 시나리오에서 URI를 지정하는 방법을 설명하는 다른 topics 대한 링크도 제공합니다.
Oracle E-Business Suite는 기본 Oracle 데이터베이스와 인터페이스하는 애플리케이션 계층으로, organization 내의 다양한 요구 사항에 따라 재무 및 HR과 같은 다양한 애플리케이션으로 분류됩니다. 이러한 각 애플리케이션은 사용자가 기본 Oracle 데이터베이스에 데이터를 입력할 수 있는 다양한 "양식"을 제공합니다. 이러한 양식에 대한 액세스는 사용자가 속한 organization ID, 사용자와 연결된 "책임" 및 사용자가 호출하려는 Oracle E-Business Suite 애플리케이션의 이름으로 구성된 애플리케이션 컨텍스트와 사용자를 연결하여 제한됩니다. 어댑터가 기본 데이터베이스에 직접 연결되고 양식을 사용하여 Oracle E-Business Suite와 인터페이스하지 않더라도 Oracle E-Business Suite 아티팩트에서 작업을 수행할 때 애플리케이션 컨텍스트를 설정해야 합니다. 따라서 Oracle E-Business 어댑터를 사용하여 Oracle E-Business 제품군 및 기본 Oracle 데이터베이스에 연결하려면 다음을 수행해야 합니다.
Oracle E-Business Suite 및 기본 Oracle 데이터베이스에 연결할 연결 URI를 지정합니다. 연결을 설정하는 동안 Oracle E-Business Suite 또는 기본 Oracle 데이터베이스에 대한 자격 증명을 지정하도록 선택할 수 있습니다.
사용자의 애플리케이션 컨텍스트를 설정합니다. Oracle E-Business 어댑터는 자격 증명 및 책임을 수락하는 특정 바인딩 속성을 노출합니다. 이러한 바인딩 속성에 대한 자세한 내용은 BizTalk Adapter for Oracle E-Business Suite 바인딩 속성에 대해 읽어보세요. 애플리케이션 컨텍스트 설정에 대한 자세한 내용은 애플리케이션 컨텍스트 설정을 참조하세요.
이 섹션에서는 tnsnames.ora를 사용하고 tnsnames.ora를 사용하지 않고 기본 데이터베이스에 연결할 연결 URI를 지정하는 방법에 대한 정보를 제공합니다. 또한 연결 URI를 사용하여 Oracle E-Business Suite에 연결하는 방법에 대한 정보를 제공합니다.
tnsnames.ora를 사용하여 연결
중요
- 이 방법을 사용하려면 어댑터 클라이언트가 설치된 컴퓨터의 tnsnames.ora 파일에 net 서비스 이름 항목을 추가해야 합니다. 순 서비스 이름 항목에 대한 자세한 내용은 E-Business Suite 어댑터에 대한 Oracle 클라이언트 구성을 참조하세요.
- Oracle 클라이언트 제한으로 인해 트랜잭션에서 작업을 수행하는 경우 연결 URI의 DataSourceName 매개 변수(net service name)는 39자를 초과할 수 없습니다. 따라서 트랜잭션에서 작업을 수행할 경우 DataSourceName 매개 변수에 지정된 값이 39자 미만인지 확인합니다.
연결 URI에는 연결할 Oracle E-Business Suite 서비스를 식별하는 데 사용되는 Oracle net 서비스 이름이 포함될 수 있습니다. Oracle 클라이언트는 Oracle E-Business Suite 서비스에 대한 연결 정보에 대한 연결 URI에서 제공하는 Oracle net 서비스 이름을 확인합니다. 이 이름은 사용하도록 구성하는 Oracle 명명 방법의 계층 구조에 따라 확인됩니다. 하나의 일반적인 명명 메서드를 로컬 명명이라고 합니다. 로컬 이름 지정에서 Oracle 클라이언트는 tnsnames.ora라는 파일을 사용하여 Oracle net 서비스 이름을 resolve.
WCF의 일반적인 엔드포인트 주소 URI는 로 표시됩니다. 여기서: scheme://userauthparams@hostinfoparams
scheme은 스키마 이름입니다.
userauthparams는 엔드포인트에서 사용자 인증에 필요한 매개 변수의 이름-값 컬렉션입니다.
hostinfoparams는 호스트에 대한 연결을 설정하는 데 필요한 정보입니다. 예를 들어 순 서비스 이름입니다.
Oracle E-Business 어댑터 연결 URI는 이 기본 형식을 준수하며 다음과 같이 구현됩니다.
oracleebs://User=[USER_NAME];Password=[PASSWORD]@[NET_SERVICE_NAME]
다음 표에서는 연결 URI에 포함된 속성을 설명합니다.
| 연결 URI 속성 | 범주 | Description |
|---|---|---|
| [USER_NAME] | userauthparams | 인증에 사용할 사용자 이름입니다. Oracle E-Business 어댑터는 클라이언트가 연결을 설정하도록 지정하는 Oracle 클라이언트 자격 증명의 유형을 지정하는 ClientCredentialType 바인딩 속성을 노출합니다. ClientCredentialType 바인딩 속성에 대한 가능한 값은 Database 및 EBusiness입니다. 이 바인딩 속성의 값에 따라 관련 자격 증명을 지정해야 합니다. 자세한 내용은 Oracle 자격 증명 및 연결 URI를 참조하세요. 참고: 연결 URI에서 사용자 이름과 암호를 지정하려면 AcceptCredentialsInUri 바인딩 속성을 true 로 설정해야 합니다. 참고: Oracle E-Business 어댑터는 Oracle E-Business Suite에 연결할 때 사용자 이름에 입력하는 값의 대/소문자를 유지하지 않습니다. 사용자 이름은 SQL*Plus의 표준 규칙을 사용하여 Oracle E-Business Suite에 전달됩니다. 그러나 사용자 이름의 대/소문자를 유지하거나 특수 문자가 포함된 사용자 이름을 입력하려면 큰따옴표 안에 값을 지정해야 합니다. |
| [PASSWORD] | userauthparams | 인증에 사용할 암호입니다. Oracle E-Business 어댑터는 클라이언트가 연결을 설정하도록 지정하는 Oracle 클라이언트 자격 증명의 유형을 지정하는 ClientCredentialType 바인딩 속성을 노출합니다. ClientCredentialType 속성이 Database로 설정된 경우 클라이언트는 Oracle 데이터베이스 사용자의 암호를 지정해야 합니다. ClientCredentialType 속성이 EBusiness로 설정된 경우 클라이언트는 Oracle E-Business Suite 사용자의 암호를 지정해야 합니다. 참고: Oracle E-Business 어댑터는 Oracle E-Business Suite에 연결할 때 암호에 입력한 값의 대/소문자를 유지하지 않습니다. 사용자 이름은 SQL*Plus의 표준 규칙을 사용하여 Oracle E-Business Suite에 전달됩니다. 그러나 암호의 대/소문자를 유지하거나 특수 문자가 포함된 암호를 입력하려는 경우 큰따옴표 안에 값을 지정해야 합니다. |
| [NET_SERVICE_NAME] | hostinfoparams | Oracle E-Business 어댑터가 설치된 컴퓨터의 tnsnames.ora 파일에 지정된 net 서비스 이름입니다. net service name 및 tnsnames.ora에 대한 자세한 내용은 E-Business Suite 어댑터에 대한 Oracle 클라이언트 구성을 참조하세요. |
tnsnames.ora를 사용하지 않고 연결
중요
- 이 방법의 경우 tnsnames.ora에 net 서비스 이름 항목이 필요하지 않습니다. 또한 어댑터 클라이언트가 설치된 컴퓨터에 tnsnames.ora 파일도 설치할 필요가 없습니다.
- 트랜잭션에서 작업을 수행하는 경우 이 연결 모드는 지원되지 않습니다. 이는 Oracle 클라이언트의 제한 때문입니다.
WCF의 일반적인 엔드포인트 주소 URI는 로 표시됩니다. 여기서: scheme://userauthparams@hostinfoparams
scheme은 스키마 이름입니다.
userauthparams는 엔드포인트에서 사용자 인증에 필요한 매개 변수의 이름-값 컬렉션입니다.
hostinfoparams는 호스트에 대한 연결을 설정하는 데 필요한 정보입니다. 예: 서버 이름, 포트 번호 등
Oracle E-Business 어댑터 연결 URI는 이 기본 형식을 준수하며 다음과 같이 구현됩니다.
oracleebs://User=[USER_NAME];Password=[PASSWORD]@[SERVER_NAME]:[PORT_NUMBER]/[SERVICE_NAME]/[SERVICE_TYPE]
다음 표에서는 연결 URI에 포함된 속성을 설명합니다.
| 연결 URI 속성 | 범주 | Description |
|---|---|---|
| [USER_NAME] | userauthparams | 인증에 사용할 사용자 이름입니다. Oracle E-Business 어댑터는 클라이언트가 연결을 설정하도록 지정하는 Oracle 클라이언트 자격 증명의 유형을 지정하는 ClientCredentialType 바인딩 속성을 노출합니다. ClientCredentialType 바인딩 속성에 대한 가능한 값은 Database 및 EBusiness입니다. 이 바인딩 속성의 값에 따라 관련 자격 증명을 지정해야 합니다. 자세한 내용은 Oracle 자격 증명 및 연결 URI를 참조하세요. 참고: 연결 URI에서 사용자 이름과 암호를 지정하려면 AcceptCredentialsInUri 바인딩 속성을 true 로 설정해야 합니다. 참고: Oracle E-Business 어댑터는 Oracle E-Business Suite에 연결할 때 사용자 이름에 입력하는 값의 대/소문자를 유지하지 않습니다. 사용자 이름은 SQL*Plus의 표준 규칙을 사용하여 Oracle E-Business Suite에 전달됩니다. 그러나 사용자 이름의 대/소문자를 유지하거나 특수 문자가 포함된 사용자 이름을 입력하려면 큰따옴표 안에 값을 지정해야 합니다. |
| [PASSWORD] | userauthparams | 인증에 사용할 암호입니다. Oracle E-Business 어댑터는 클라이언트가 연결을 설정하도록 지정하는 Oracle 클라이언트 자격 증명의 유형을 지정하는 ClientCredentialType 바인딩 속성을 노출합니다. ClientCredentialType 속성이 Database로 설정된 경우 클라이언트는 Oracle 데이터베이스 사용자의 암호를 지정해야 합니다. ClientCredentialType 속성이 EBusiness로 설정된 경우 클라이언트는 Oracle E-Business Suite 사용자의 암호를 지정해야 합니다. 참고: Oracle E-Business 어댑터는 Oracle E-Business Suite에 연결할 때 암호에 입력한 값의 대/소문자를 유지하지 않습니다. 사용자 이름은 SQL*Plus의 표준 규칙을 사용하여 Oracle E-Business Suite에 전달됩니다. 그러나 암호의 대/소문자를 유지하거나 특수 문자가 포함된 암호를 입력하려는 경우 큰따옴표 안에 값을 지정해야 합니다. |
| [SERVER_NAME] | hostinfoparams | Oracle E-Business Suite가 실행 중인 서버의 이름입니다. 필수 항목입니다. |
| [PORT_NUMBER] | hostinfoparams | Oracle Net Listener 포트입니다. 기본값 1521입니다. |
| [SERVICE_NAME] | hostinfoparams | Oracle 데이터베이스 서비스 이름입니다. 필수 항목입니다. |
| [SERVICE_TYPE] | hostinfoparams | Oracle 서비스의 유형입니다. 가능한 값은 전용 또는 공유입니다. 전용 서비스는 전용 서버 프로세스를 사용하여 하나의 사용자 프로세스만 제공합니다. 공유 서비스는 여러 사용자 프로세스를 제공할 수 있는 공유 서버 프로세스를 사용합니다. 기본값은 Dedicated입니다. |
Oracle 자격 증명 및 연결 URI
기본적으로 Oracle E-Business 어댑터는 Oracle 자격 증명이 연결 URI에 지정된 경우 예외를 throw합니다. 이러한 자격 증명은 연결 URI에서 일반 텍스트로 표시되므로 보안 위험이 발생합니다. AcceptCredentialsInUri 바인딩 속성을 설정하여 연결 URI에 Oracle 데이터베이스에 대한 자격 증명을 포함할 수 있는지 여부를 제어할 수 있습니다. AcceptCredentialsInUri 속성이 기본값인 false이면 연결 URI에 Oracle 자격 증명이 포함된 경우 Oracle E-Business 어댑터가 예외를 throw합니다. 속성이 true이면 예외가 throw되지 않습니다.
중요
문자열의 자격 증명을 일반 텍스트로 전달하여 발생하는 보안 위험으로 인해 연결 URI에 Oracle 데이터베이스 연결 자격 증명을 지정하지 않아야 합니다. Oracle 데이터베이스에 대한 자격 증명을 보다 안전하게 제공하는 방법에 대한 자세한 내용은 Oracle EBS 애플리케이션 보안을 참조하세요.
Oracle E-Business Suite에 대한 연결을 설정하기 위해 데이터베이스 자격 증명 또는 Oracle E-Business Suite 자격 증명을 지정하도록 선택할 수도 있습니다. 어댑터는 ClientCredentialType, OracleUserName, OraclePassword 등의 세 가지 바인딩 속성을 노출하여 이 동작을 사용하도록 설정합니다.
ClientCredentialType 바인딩 속성에 대한 가능한 값은 Database 및 EBusiness입니다.
ClientCredentialType 속성이 Database로 설정된 경우 클라이언트는 데이터베이스 자격 증명을 지정해야 합니다.
ClientCredentialType 속성이 EBusiness로 설정된 경우 클라이언트는 Oracle E-Business Suite 자격 증명을 지정해야 합니다. 이 경우 어댑터 클라이언트는 OracleUserName 및 OraclePassword 바인딩 속성에 대한 데이터베이스 자격 증명도 지정해야 합니다.
중요
어댑터 클라이언트가 ClientCredentialType 바인딩 속성을 Database로 설정하여 Oracle E-Business Suite에 연결할 데이터베이스 자격 증명을 지정하지만 Oracle E-Business Suite 아티팩트를 호출하는 시나리오에서는 OracleUserName 및 OraclePassword 바인딩 속성에 지정된 값이 애플리케이션 컨텍스트를 설정하는 데 사용됩니다. 애플리케이션 컨텍스트 설정은 Oracle E-Business Suite에서 아티팩트 호출에 필수입니다. 애플리케이션 컨텍스트 설정에 대한 자세한 내용은 애플리케이션 컨텍스트 설정을 참조하세요.
연결 URI에서 예약 문자 사용
Oracle E-Business 어댑터는 매개 변수 값에 특수 문자가 있는 연결 URI 지정을 지원하지 않습니다. 연결 매개 변수 값에 특수 문자가 포함된 경우 다음 중 하나를 수행해야 합니다.
어댑터 서비스 참조 플러그 인 추가 또는 어댑터 서비스 추가 기능 사용을 사용하여 Visual Studio에서 URI를 지정하는 경우 이스케이프 문자를 사용하지 않고 URI 속성 탭에서 그대로 지정해야 합니다. URI 구성 필드에서 직접 URI를 지정하고 연결 매개 변수에 예약된 문자가 포함된 경우 적절한 이스케이프 문자를 사용하여 연결 매개 변수를 지정해야 합니다.
BizTalk Server 관리 콘솔에서 송신 또는 수신 포트를 만드는 동안 URI를 지정하고 연결 매개 변수에 예약된 문자가 포함된 경우 적절한 이스케이프 문자를 사용하여 연결 매개 변수를 지정해야 합니다.
연결 URI를 사용하여 Oracle E-Business Suite에 연결
다음은 tnsnames.ora를 사용하는 Oracle E-Business 어댑터에 대한 연결 URI의 예입니다.
oracleebs://ADAPTER
이 예제에서 어댑터는 tnsnames.ora의 대상 Oracle 데이터베이스에 대한 서비스 이름 및 연결 정보와 연결된 net 서비스 이름입니다.
다음은 tnsnames.ora를 사용하지 않고 Oracle E-Business 어댑터에 대한 연결 URI의 예입니다.
oracleebs://yourOracleServer:1521/yourOracleDatabaseServiceName/Dedicated
이 예제에서 서버 이름은 "yourOracleServer"이고 서비스 이름은 "yourOracleDatabaseServiceName"입니다.
Oracle E-Business Suite에 대한 연결을 설정하는 방법에 대한 자세한 내용은 다음을 수행합니다.
어댑터 서비스 BizTalk 프로젝트 추가 기능 사용 또는 어댑터 서비스 참조 Visual Studio 플러그 인 추가를 사용합니다. Visual Studio에서 Oracle E-Business Suite에 연결을 참조하세요.
BizTalk Server 솔루션에서 송신 포트 또는 수신 포트(위치)를 구성합니다. Oracle E-Business 어댑터에 대한 물리적 포트 바인딩 수동 구성을 참조하세요.
참고 항목
E-Business Suite 어댑터에 대한 Oracle 클라이언트 구성
Windows 인증을 사용하여 Oracle E-Business Suite에 연결
Oracle E-Business Suite에 대한 연결 만들기