1단계: Oracle E-Business 어댑터를 사용하여 WCF 서비스 만들기 및 게시
완료 시간: 15분
목표: WCF LOB 어댑터 서비스 개발 마법사를 사용하여 IIS(인터넷 정보 서비스) 또는 WAS(Windows 프로세스 정품 인증 서비스)와 같은 호스팅 환경에서 호스팅할 수 있는 Oracle E-Business Suite 아티팩트에서 WCF 서비스를 생성할 수 있습니다. 이 항목에서는 마법사를 사용하여 WCF 서비스 파일을 생성하는 방법을 보여 줍니다.
필수 구성 요소
마법사를 실행하기 전에 다음을 설치합니다.
Microsoft WCF(Windows Communication Foundation) LOB(기간 업무) 어댑터 SDK에는 완료 옵션 또는 사용자 지정 옵션(이 옵션 내에서 도구 선택)이 있습니다. 그러면 어댑터 서비스 개발 마법사용 Visual Studio 템플릿이 설치됩니다.
BizTalk 어댑터 팩의 Oracle E-Business Suite용 Microsoft BizTalk 어댑터.
이러한 필수 구성 요소에 대한 자세한 내용은 BizTalk 어댑터 팩 설치 가이드를 참조하세요. 설치 가이드는 일반적으로 설치 드라이브>:\Program Files\Microsoft BizTalk Adapter Pack\Documents에 설치<됩니다.
참고
또한 Microsoft Office SharePoint Server 샘플과 함께 제공되는 create_apps_artifacts.sql 스크립트를 실행하여 애플리케이션 개체 라이브러리 애플리케이션에서 MS_SAMPLE_EMPLOYEE 인터페이스 테이블을 만들어야 합니다. 이 인터페이스 테이블은 이 자습서에서 사용됩니다.
Oracle E-Business 아티팩트 작업에 대한 WCF 서비스 만들기
이 섹션에서는 MS_SAMPLE EMPLOYEE 인터페이스 테이블에서 선택 작업에 대한 WCF 서비스를 만드는 단계를 제공합니다.
MS_SAMPLE EMPLOYEE 인터페이스 테이블에서 작업 선택용 WCF 서비스를 만들려면
Visual Studio를 시작한 다음 프로젝트를 만듭니다.
새 프로젝트 대화 상자의 프로젝트 형식 창에서 Visual C#을 선택합니다. 템플릿 창에서 WCF 어댑터 서비스를 선택합니다.
또는 프로젝트 형식 창에서 Visual C#을 확장한 다음 웹을 선택합니다. 템플릿 창에서 WCF 어댑터 서비스를 선택합니다.
참고
웹 개발 구성 요소를 사용하여 Visual Studio 2013 설치한 경우 새 웹 사이트 옵션(파일>새>웹 사이트)에서 WCF 어댑터 서비스 템플릿도 사용할 수 있습니다.
그러나 Oracle E-Business 어댑터는 파일 시스템에서 만든 웹 사이트만 지원합니다. 따라서 새 웹 사이트 대화 상자에서 웹 사이트를 만드는 동안 위치 목록에서 파일 시스템을 클릭해야 합니다.
솔루션의 이름과 위치를 지정한 다음 확인을 클릭합니다. WCF 어댑터 서비스 개발 마법사가 시작됩니다.
Welcome 페이지에서 다음을 클릭합니다.
작업 선택 페이지에서 Oracle E-Business Suite에 연결할 연결 문자열 지정합니다. 그러려면 다음을 수행합니다.
바인딩 선택 목록에서 oracleEBSBinding을 클릭한 다음 구성을 클릭합니다.
어댑터 구성 대화 상자에서 바인딩 속성 탭을 클릭합니다.
일반 범주에서 ClientCredentialType 바인딩 속성에 대해 EBusiness를 선택합니다.
OracleEBS 범주에서 OracleUserName, OraclePassword 및 OracleEBSResponsibilityName 바인딩 속성에 적절한 값을 지정합니다. 이 경우 OracleUserName 및 OraclePassword 바인딩 속성에 대한 데이터베이스 자격 증명을 제공해야 합니다.
메타데이터 범주에서 EnableSafeTyping 바인딩 속성에 대해 True를 선택합니다. 날짜 열의 값을 검색하는 경우 메타데이터를 생성할 때 EnableSafeTyping 바인딩 속성을 True 로 설정하는 것이 좋습니다.
URI 속성 탭을 클릭한 다음 연결 매개 변수에 대한 값을 지정합니다. Oracle E-Business 어댑터의 연결 URI에 대한 자세한 내용은 Oracle E-Business Suite 연결 URI 만들기를 참조하세요.
보안 탭을 클릭하고 클라이언트 자격 증명 유형 목록에서 사용자 이름을 선택합니다. Oracle E-Business Suite에 연결할 유효한 Oracle E-Business Suite 사용자 이름과 암호를 지정합니다.
확인을 클릭하여 어댑터 구성 대화 상자를 닫은 다음 연결을 클릭합니다. Visual Studio가 Oracle E-Business Suite와의 연결을 성공적으로 설정하면 연결 상태 연결된 것으로 표시됩니다. Oracle E-Business Suite 메타데이터가 작업 선택 페이지에 표시되는 것을 볼 수도 있습니다.
작업 선택 페이지의 계약 유형 선택 목록에서 클라이언트(아웃바운드 작업)를 클릭합니다.
범주 선택 상자에서 Application Object 라이브러리 애플리케이션의 MS_SAMPLE_EMPLOYEE 인터페이스 테이블로 이동합니다. 어댑터에서 아티팩트를 검색하는 방법에 대한 자세한 내용은 Oracle E-Business 작업에 대한 메타데이터 찾아보기, 검색 및 검색을 참조하세요.
사용 가능한 범주 및 작업 상자에서 선택 작업을 선택한 다음 추가를 클릭합니다. 선택 작업이 추가된 범주 및 작업 상자에 추가됩니다.
추가참고
각 아티팩트마다 둘 이상의 작업을 추가할 수 있습니다. 다양한 Oracle E-Business Suite 아티팩트 작업을 추가할 수도 있습니다. 예를 들어 인터페이스 테이블에 대해 하나의 작업을 추가하고 동시 프로그램에 대해 다른 작업을 추가할 수 있습니다. 또한 검색 식에서 와일드카드 문자를 지정하여 특정 작업을 검색할 수 있습니다. 지원되는 특수 문자 및 작업을 검색할 수 있는 노드 수준에 대한 자세한 내용은 Oracle E-Business Suite 작업 검색을 참조하세요.
작업 선택 페이지에서 다음을 클릭합니다.
서비스 및 엔드포인트 동작 구성 페이지에서 서비스 및 엔드포인트 동작을 구성하는 값을 지정합니다.
서비스 동작 구성 상자에서 다음 값을 지정합니다.
속성의 경우 값 지정 EnableMetadataExchange 메타데이터 교환 엔드포인트를 만들려면 이를 True 로 설정합니다. 이를 True로 설정하면 MEX(WS-Metadata Exchange) 및 HTTP/GET 요청과 같은 표준화된 프로토콜을 사용하여 서비스 메타데이터를 사용할 수 있게 됩니다. 기본값은 False입니다. IncludeExceptionDetailsinFault 디버깅을 위해 클라이언트에 반환된 SOAP 오류에 대해 자세히 관리되는 예외 정보를 포함하려면 이를 True 로 설정합니다. 기본값은 False입니다. Name 서비스 동작 구성의 이름입니다. 이 자습서에서는 customServiceBehavior를 입력합니다. UseServiceCertificate WCF의 메시지 수준 보안 모드를 사용할지 여부를 지정합니다. 기본값은 True입니다. 이 자습서에서는 False로 설정해야 합니다. 참고
이 자습서에서는 서비스 인증서를 사용하지 않으므로 FindValue, StoreLocation, StoreName 및 X509FindType 속성에 대한 값을 제공할 필요가 없습니다. 인증서 및 관련 속성에 대한 자세한 내용은 의 "X509ClientCertificateCredentialsElement 속성" https://go.microsoft.com/fwlink/?LinkId=103771을 참조하세요.
엔드포인트 동작 구성 상자에서 다음 값을 지정합니다.
속성의 경우 값 지정 인증 유형 Microsoft Office SharePoint Server가 WCF 서비스를 사용하려면 이를 HTTPUserNamePassword로 설정해야 합니다. 이렇게 하면 클라이언트가 HTTP 헤더의 일부로 사용자 이름 및 암호를 지정할 수 있습니다. Name 엔드포인트 동작 구성의 이름을 지정합니다. 이 자습서에서는 customEndpointBehavior를 입력합니다. UsernameHeader 사용자 이름 헤더의 이름입니다. 이 예제에서는 MyUserHeader를 지정합니다. HTTP 헤더에 대한 자세한 내용은 에서 "사용자 지정 HTTP 및 SOAP 헤더 지원"을 https://go.microsoft.com/fwlink/?LinkId=106692참조하세요. 참고:인증 유형 이 HTTPUserNamePassword로 설정된 경우 이 속성의 값을 지정해야 합니다. 인증 유형이 Auto로 설정된 경우 이 속성은 선택 사항입니다. PasswordHeader 암호 헤더의 이름입니다. 이 예제에서는 MyPassHeader를 지정합니다. HTTP 헤더에 대한 자세한 내용은 의 "사용자 지정 HTTP 및 SOAP 헤더 지원"을 https://go.microsoft.com/fwlink/?LinkId=106692참조하세요. 참고:인증 유형 이 HTTPUserNamePassword로 설정된 경우 이 속성의 값을 지정해야 합니다. 인증 유형이 Auto로 설정된 경우 이 속성은 선택 사항입니다. 다음 그림에서는 지정된 값을 사용하여 서비스 및 엔드포인트 동작 구성 페이지를 보여 줍니다.
서비스 및 엔드포인트 동작 구성 페이지에서 다음을 클릭합니다.
서비스 엔드포인트 바인딩 및 주소 구성 페이지에서 구성할 계약 선택 페이지에 구성한 아티팩트(MS_SAMPLE_EMPLOYEE)가 표시됩니다. 선택한 계약 상자 아래의 작업에는 작업 선택 페이지의 아티팩트에서 선택한 선택 작업이 표시됩니다.
계약 주소 및 바인딩 구성 상자에서 다음 값을 지정합니다.
속성의 경우 값 지정 바인딩 구성 마법사는 기본 HTTP 바인딩만 지원합니다. 따라서 바인딩 구성 필드는 System.ServiceModel.Configuration.BasicHttpBindingElement에 자동으로 채워집니다.
줄임표 단추 (...) 를 클릭하여 HTTP 바인딩에 대한 속성을 변경합니다. 보안 통신 채널을 사용하려면 항상 Mode 속성을 전송으로 설정해야 합니다. 마법사는 Mode 속성의 기본값을 전송으로 설정합니다.
노출된 다른 바인딩에 대한 자세한 내용은 의 "BasicHttpBindingElement 멤버" https://go.microsoft.com/fwlink/?LinkId=103773를 참조하세요.엔드포인트 이름 계약의 엔드포인트 이름을 지정합니다. 이 페이지의 다른 필드는 이전 페이지에서 지정한 값에 따라 자동으로 채워집니다.
적용을 클릭합니다.
참고
이 페이지에서 값을 지정하지 않으면 모든 계약에 대해 기본값이 허용됩니다.
다음 그림에서는 지정된 값을 사용하여 서비스 엔드포인트 바인딩 및 주소 구성 페이지를 보여줍니다.
구성서비스 엔드포인트 바인딩 및 주소 구성 페이지에서 다음을 클릭합니다. 요약 페이지에는 Oracle E-Business Suite 아티팩트 트리 구조와 아티팩트에서 선택한 작업이 나열됩니다.
요약을 검토한 다음 마침을 클릭합니다.
마법사는 WCF 서비스를 만들고 Visual Studio 프로젝트에 다음 파일을 추가합니다.
.svc 파일. WCF 서비스 파일입니다. 마법사는 각 계약에 대해 하나의 파일을 생성합니다.
Web.config 파일입니다.
서비스 코드(.cs 파일)
.cs 파일 수정
Oracle E-Business 어댑터를 사용하여 Oracle E-Business Suite 아티팩트에서 서비스를 만들고 Microsoft Office SharePoint Server의 비즈니스 데이터 목록 웹 파트에서 사용하려는 경우 WHERE 절부터 전체 필터 절을 제공해야 합니다. 예를 들어 이름이 "John"인 직원을 검색하려면 비즈니스 데이터 목록 웹 파트에서 다음 필터 절을 제공해야 합니다.
where NAME like ‘JOHN’
그러나 사용자가 전체 필터 절을 실제로 언급하지 않고 필터 절에 대한 입력으로만 이름을 제공하려는 경우 Microsoft Office SharePoint Server의 비즈니스 데이터 목록 웹 파트에서 들어오는 필터 절을 수정하는 코드를 .cs 파일에 추가하여 WHERE 절 형식으로 Oracle E-Business에 전달할 수 있습니다.
예를 들어 이 자습서의 경우 사용자가 Microsoft Office SharePoint Server의 비즈니스 데이터 목록 웹 파트에 직원 이름을 입력하고 해당 직원에 대한 레코드를 검색하도록 하려면 .cs 파일에 다음 코드를 추가할 수 있습니다.
SelectResponse InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.Select(SelectRequest request)
{
request.FILTER = "where NAME like '" + request.FILTER + "'"; // The code to avoid the users from specifying the WHERE clause in the filter from Business Data List Web Part.
return base.Channel.Select(request);
}
WCF 서비스 게시
IIS에 대해 SSL이 사용하도록 설정되어 있는지 확인합니다. IIS용 SSL을 사용하도록 설정하는 방법에 대한 지침은 을 참조하세요 https://go.microsoft.com/fwlink/?LinkId=197170.
WCF 서비스를 게시하려면 다음을 수행합니다.
솔루션 탐색기 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 게시를 클릭합니다.
웹 게시 대화 상자에서 WCF 서비스의 URL을 지정합니다. 예:
https://<COMPUTER_NAME>:<PORT_NUMBER>/MS_SAMPLE_EMPLOYEE/참고
SSL 사용 위치에 WCF 서비스를 게시해야 합니다. 즉, 대상 위치 상자의 값은 "https://"로 시작해야 합니다. 사용자 자격 증명이 HTTP 헤더에 전달되기 때문에 마법사는 "전송"을 보안 모드로 사용하도록 어댑터의 바인딩 동작을 자동으로 구성했습니다. 이는 SSL 암호화를 의미합니다. 물론 돌아가서 web.config 파일을 편집하여 보안 모드> 매개 변수의 값을 변경할 수 있지만, HTTP 헤더에서< 중요한 정보가 명확한 텍스트로 전송되는 경우 SSL을 사용하는 것이 항상 더 나은 옵션입니다.
복사 상자에서 모든 프로젝트 파일을 클릭합니다.
게시를 클릭합니다.
WCF 서비스가 성공적으로 게시되었는지 확인합니다.
IIS Microsoft 관리 콘솔을 시작합니다. 시작을 클릭하고 관리 도구를 가리킨 후 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
서비스를 게시한 노드로 이동합니다. MS_SAMPLE_EMPLOYEE 서비스의 경우 인터넷 정보 서비스><컴퓨터 이름>>웹 사이트기본 웹 사이트>>MS_SAMPLE_EMPLOYEE 이동합니다.
오른쪽 창에서 InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.svc 파일을 마우스 오른쪽 단추로 클릭한 다음 찾아보기를 클릭합니다.
웹 페이지에 WSDL을 검색하기 위한 URL이 표시됩니다. svcutil 명령을 사용하여 메타데이터 검색을 테스트할 수 있습니다. 예를 들어 MS_SAMPLE_EMPLOYEE 서비스에 대한 메타데이터를 검색하는 명령은 다음과 같습니다.
svcutil.exe https://<COMPUTER_NAME>:<PORT_NUMBER>/MS_SAMPLE_EMPLOYEE/InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.svc?wsdl
다음 단계
Oracle E-Business Suite 아티팩트용 애플리케이션 정의 파일을 만들려면 Business Data Catalog 정의 편집기를 사용합니다. 자세한 내용은 2단계: Oracle E-Business Suite 아티팩트용 애플리케이션 정의 파일 만들기를 참조하세요. 애플리케이션 정의 파일은 LOB 데이터가 저장되는 위치와 저장되는 형식을 식별합니다.