Brain to Blog

Introduction

In this chapter, you will learn to use Oracle Service Bus to
    • Virtualize Application Services through JCA Adapters such as Oracle eBusiness Suite, Siebel, PeopleSoft etc.
    • Mediate access to data in the Database along with Protocol bridging Employees at Mega Corporation use the
      Employee Self Service portal to submit

Requisition requests for items required to carry on their job functions. Once the Requisition gets approved, Purchase Order is generated for the Requisition. The Purchase Order is then submitted to the Supplier, Pega Corporation. Supplier validates the requestor’s Credit Card, approves the Purchase Order if required, and fulfills the Order.

Mega Corporation has implemented the Requisition process in Oracle eBusiness Suite. Supplier, Pega Corporation, has implemented the Purchase Order process in Oracle SOA Suite.

Overview of the business processes at work between Mega, on the left, with Procure to Pay business process, interfacing with Pega, on the right, with Order-to-Cash business process.

※ 세션 생성과 완료는 생략 하겠습니다. 수정하려면 세션을 만들어야 하고, 테스트 해볼려면 수정사항이 완료되어 있어야 합니다.

Create Requisition

BPEL 에서 만든 JCA DB Adapter 를 OSB에서 불러와서 사용해 봅시다!

 

Create Database Adapter artifacts in JDeveloper

JDeveloper 실행 - Application 생성.



Application Name: SOADemo
Application Template: SOA Application

Project Name: DBArtifacts

 

Finish 클릭.

 

Database Adapter 컴포넌트를 External References 영역에 드래그 앤 드랍합니다.

 

Service Name: createRequisition


 
Connection 추가

 

soademo 커넥션 정보 입력.

 

JNDI Name: eis/DB/soademoDatabase

※ 기본적으로 eis/DB/{Connection Name} 으로 설정 됩니다.

 

※ 물론 웹로직 콘솔에 아래와 같이 세팅이 되어 있어야 겠죠?

 

Operation Type: Perform an Operation on a Table - Insert Only

 

Inport Tables... 클릭.


 
"OSB_REQUISITION" 테이블 선택.

 

오른쪽에 들어가 있어야 선택된 겁니다.

 

Next 클릭.

 

기본키는 REQID 선택.

 

Finish 클릭.

 

Database Adapter가 추가 되었습니다.




Import Database Adapter artifacts into Oracle Service Bus

Oracle Service Bus Console 접속.

Requisition 프로젝트를 생성합니다.

Requisition 프로젝트 아래에 Resources 폴더를 생성합니다.

Resources 폴더에서 리소를 추가합니다. Zipped Resources 선택.

※ 랩 문서에서는 soa와 jdeveloper가 로컬에서 돌아가서 Resources form URL 선택 후 file:// 을 사용했는데, 저는 soa가 다른 곳에 띄워져 있어서 zip 파일을 업로드 하겠습니다.

JDeveloper로 만든 프로젝트(DBArtifacts)로 가서 아래와 같은 3개의 파일과 1개의 포더를 압축해 놓습니다.

zip 파일을 업로드합니다.

아래와 같이 4개의 파일이 선택되어져 있어야 합니다.

Requisition/Resources/createRequisition_db – JCA Binding
Requisition/Resources/createRequisition – WSDL
Requisition/Resources/xsd/createRequisition_table – XML Schema
Requisition/Resources/createRequisition-or-mappings – XML Document

Import 클릭.

Inport 되었습니다.

Create Business Service from Database Adapter JCA File

Requisition 프로젝트 아래 BusinessServices 폴더를 생성합니다.

Resources 폴더로 가서 Generate 버튼을 클릭합니다.

Requisition - BusinessServices 선택. Generate 버튼 클릭.

Requisition - Resources 폴더에 가보면 아래와 같이 2개(WSDL, BS)가 생성되어 있습니다.

Create Proxy Service for Business Service

Requisition 프로젝트 아래에 ProxyServices 폴더를 생성합니다.

ProxyServices 폴더에서 Proxt Service 를 생성합니다.

Service Name: createRequisition

Create From Existing Service 아래에 Business Service 선택 후 Browse... 클릭.

Requisition/BusinessServices/createRequisition_db 선택 후 Submit 클릭.

Next 클릭

Protocal: http

EndpointURI 는 자동으로 만들어집니다. Next 클릭.

Last 클릭.

Save 클릭.

Update Proxy Service Message Flow

Requisition - ProxyServices 로 이동.

createRequisition 의 Message Flow 수정.

createRequisition 클릭 - Add Pipeline Pair 선택

Request Pipeline 클릭 - Add Stage

stage1 클릭 - Edit Stage

Add an Action 클릭 Reporting - Report

Report: $body
Key Name: REQ_ID
variable: body

<XPath> 클릭.

./cre:OsbRequisitionCollection/cre:OsbRequisition/cre:reqid

입력 후 Save All 클릭.

Test

createRequisition(Proxy Service)를 테스트 해봅시다!

주문 정보 입력 후 Execute 버튼 클릭.

실행 되었습니다.

Message Reports 에 가보면 Report 가 남아있는 것을 볼 수 있습니다.

직접 DB를 select 해보면 인서트가 되었습니다.

Receive PO

DB Pooling 기능을 하는 JCA DB Adapter 를 가져와서 사용해 봅시다!

Create Database Adapter artifacts in Jdeveloper

전에 JDeveloper 로 만들었던 DBArtifacts 프로젝트를 그냥 사용합니다.

Database Adapter 컴포넌트를 Exposed Services 영역에 추가 합니다.

Service Name: receivePO

Connection: soadameDatabase
JNDI Name: eis/DB/soademoDatabase

Operation Type: Poll for New or Changed Records in a Table

"OSB_PURCHASEORDER" 테이블 선택.

기본키는 ID

"Delete the Row(s) that were Read" 선택 (읽어 들인 후 삭제 처리) - FInish 클릭.

Database Adapter 가 추가되었습니다.

Import Database Adapter artifacts into Oracle Service Bus

PoProcessing 프로젝트와 하위에 BusinessServices, ProxyServices, Resources 폴더를 생성합니다.

Resources 폴더에서 리소스를 추가합니다. Zipped Resources 선택.

아래와 같이 4개의 파일을 압축한 zip 파일을 파일 첨부합니다.

Next 클릭.

xsd/createRequisiton_table.xsd 파일은 전에 사용했던 파일이니 필요 없습니다.

POProcessing/Resources/receivePO_db – JCA Binding
POProcessing/Resources/receivePO – WSDL
POProcessing/Resources/xsd/receivePO_table – XML Schema
POProcessing/Resources/receivePO-or-mappings – XML Document

Create Proxy Service from Database Adapter JCA File

POProcessing 프로젝트 - Resources 폴더에서 receivePO_db(JCA Binding)의 오른쪽 Generate 버튼 클릭.

Project: POProcessing
Sub-folder: ProxyServices

Generate 클릭.

POProcessing - ProxyServices 폴더에 보면 Proxy Service가 생성 되었습니다.

Import WSDL for POProcessing Composite Service in SOA Suite

POProcessing - Resources 폴더에서 리소스를 추가합니다. Resources from URL 선택.

현재 SOA에 올라가 있는 POProcessing 조합의 WSDL 주소를 복사해 넣습니다.

Resource Name: receivePO_SOA

Import 클릭.

Create Business Service from WSDL

POProcessing - BusinessServices 폴더에서 비지니스 서비스를 생성합니다.

Service Name: receivePO

WSDL Web Service 선택 후 Browse... 클릭.

POProcessing/Resources/receivePO_SOA 선택 후 Ports - execute_pt 선택.

Submit 클릭.

Next 클릭.

Last 클릭.

Save 클릭.

Complete Proxy Service Message Flow

POProcessing - ProxyServices 폴더의 receivePO_db(Proxy Service)의 메세지 흐름을 편집합니다.

receivePO_db 클릭 - Add Route 클릭.

RouteNode1 클릭 - Edit Route 클릭.

Add an Action 클릭 - Communication - Routing 클릭.

<Service> 클릭.

POProcessing/BusinessServices/receivePO 선택 - Submit 클릭.

Operation: execute

Save 버튼 클릭.

receivePO_db 클릭 - Add Pipeline Pair 클릭.

Request Pipeline 클릭 - Add Stage 클릭.

stage1 클릭 - Edit Stage 클릭.

Add an Action 클릭. Reporting - Report 클릭.

Report: $body
Key Name: DB_ID
variable: body

<XPath> 클릭.

./rec:OsbPurchaseorderCollection/rec:OsbPurchaseorder/rec:id

Save 클릭.

Save 클릭.

stage1 아래 Stage 추가

stage2 수정

Message Processing - Assign 액션 추가.

<Expression> 클릭.

$body/rec:OsbPurchaseorderCollection/rec:OsbPurchaseorder

Save 클릭.

variable: dbPO

Save All 클릭.

dbPO_to_soaPO.xq 파일을 압축해 놓습니다.

POProcessing - Resources 폴더에서 리소스를 추가합니다. (Zipped Resources)

파일을 업로드 하고, XQuery 리소스 타입(Resource Type)의 확장자(File Extension)를 ".xq"로 변경합니다.

Next 클릭.

Import 클릭.

다시 POProcessing - ProxyServices 폴더에서 receivePO_db 프락시 서비스의 메시지 흐름을 수정합니다.

stage2 를 수정합니다.

Message rocessing - Assign 액션을 추가합니다.

<Expression> 클릭.

편지창 위에 "XQuery Resources" 클릭.

XQuery: 오른쪽에 Browse... 버튼 클릭.

dbPO_to_soaPO 선택 후 Submit 클릭.

Binding: $dbPO

Save 버튼 클릭.

variable: soaPO

Message Processing - Assign 액션 추가.

"<soap-env:Body>{$soaPO}</soap-env:Body>" 입력 후 Save 클릭.

variable: body

Save 클릭.

stage2 아래에 Stage 추가.

stage3 수정.

Reporting - Report 액션 추가.

Report: $body
Key Name: SOA_ID

<XPath> 클릭.

화면 왼쪽 중간에 User Defined Namespaces 영역에서 "Add Namespace" 클릭.

Prefix: ord
URI: http://xmlns.oracle.com/ns/order

Add 버튼 클릭.

./ord:PurchaseOrder/ord:ID

Save 버튼 클릭.

variable: body

Save All 버튼 클릭.

Test

테스트 해봅시다!

Requisition - ProxtServices 폴더에서 createRequisition 프락시 서비스를 테스트 합니다.

주문 정보를 입력 후 Execute 버튼 클릭.

실행 되었습니다.

Report 내용을 보면 아래와 같이 Report가 남았습니다.

EM 에서 보면 POProcessing 이 실행되 것을 확인할 수 있습니다.

근데 이게 보면 좀 이상합니다.

Requisition 프로젝트의는 입력을 받아서 "OSB_REQUISITION" 테이블에 INSERT 합니다.



POProcessing 프로젝트는 OSB_PURCHASEORDER 테이블의 데이터를 폴링(Pooling)해서 POProcssing 웹서비스를 실행합니다.



그런데 테스트를 해보면 Requisition 시작에부터 POProcessing 끝까지 한번에 실행 되었습니다.

왜 그럴까여?!!!

이유는 거의 마지막에 작업했던 dbPO_to_soaPO 바인딩 때문에 그렇습니다.

그럼 POProcessing 프로젝트만 제대로 되는지 테스트 해보겠습니다.

"OSB_PURCHASEORDER" 테이블에 직접 데이터를 INSERT 해보겠습니다.

insert into osb_purchaseorder values (
  '1111', '2222', 'iPod shuffle', 'Electronics', 1, 500, 'Initial','Mastercard','1234-1234-1234-1234'
);

commit;

잠시후 select 해보면 데이터가 없습니다. 네.. JCA Adatper 가 가져갔습니다.

OSB 콘솔과 EM에서 확인해보면 아래와 같이 실행된 것을 볼 수 있습니다. (시간 확인)

 

Introduction

With the new POProcessing system in place, Pega’s widget supply business continues to grow rapidly.
However, with growth there are now some problems developing from Customer Support. Recently, Pega’s Customer Support has alerted the IT department there have been complaints regarding certain aspects of the new POProcessing service.

Many Purchase Orders are being rejected due to credit card transactions processing failures. The failure rate has been thirty percent and deemed unacceptable by Mega Corporation, one of Pega’s largest customers. Mega, who should never have a declined credit issue, has escalated to Pega’s Executive Mangement. Rapid improvements must occur in the next 30 days or they will consider switching to another supplier.

Upon investigation of the complaints, Pega’s IT identified two issues:
1. The current Credit Service Validation Service Provider is unreliable and cannot handle the load required by Pega’s growing customer base.
2. Due to the failures, Mega keeps checking status of the PO orders causing unnecessary load and spikes on Pega’s infrastructure.

Upon completion of this Lab, you will learn how Oracle Service Bus can help provide solutions to both issues. OSB will help Pega scale their integration infrastructure through Endpoint Management and Service Result Caching.




Endpoint Management

L4 같은거 처럼 OSB 단에서 Endpoint를 여러개 두고 라우팅 할 수 있습니다. (기능은 미약하겠지만?...)

 

OSB에서 CreditValidation 서비스를 더 추가해봅시다.

저는 아래와 같이 파티션만 나워서 같은 서비스를 하나 더 등록했습니다.

파티션 만드는 법은 soa-infra 에서 마우스 오른쪽 버튼 클릭 - Manage Partitions 선택

"Create" 버튼 클릭 후 파티션 이름을 입력하면 만들어집니다.

이제 OSB 콘솔로 접속해서 세션을 생성합니다.

Porject Explorer - Credit_Services - ProxyServices 이동 후 validationForCC 선택

"Transport Configuratinn"을 수정합니다.

또 하나의 WSDL 주소를 추가합니다.

아래와 같이 두개의 서비스 대상이 추가되었습니다. Next 클릭.

Save 클릭.

Operations - Dashboard - Service Health 탭으로 이동 후 "validationForCC"을 선택합니다.

"Endpoint URIs" 탭을 보면 아래와 같이 확인할 수 있습니다. 현재는 실행된게 없군용...

수정사항 적용 후 테스트 해봅시다.

Project Explorer - Credit_Services - ProxyServices 에서 "ValidateCredit"를 테스트 합니다.

카드번호: 1234-1234-1234-1234

총 10번을 테스트 해봅니다.

그 후 EM에서 인스턴스가 실행된 결과를 보면 아래와 같이 5번씩 번갈아서 실행된 것을 볼 수 있습니다.

이번에는 dummy 파티션의 validationForCC 조합을 배치 해제 하겠습니다.

OSB 콘솔에서 다시 10번을 테스트 해보면 default 파티션쪽의 서비스 5번만 실행된 것을 볼 수 있습니다.

정리해보면 아래와 같습니다. 에러가 나든 말든 무조건 분기 하는군요.. ㄷㄷ..

에러가 난것은 패스되게 할 수 없을까? -_-;; 물론 있습니다!

"BusinessServices"에 "validationForCC"을 수정합시다.

"Operational Settings" 탭에 보면 "Offline Endpoint URIs" 라는 부분을 활성화 시키면 됩니다.

아래와 같이 설정을 하게되면 최초 한번은 그냥 시도를 하고 에러가 났을 때 5분 동안은 다시 그 서비스를 부르지 않습니다.

5분이 지나면 다시 한번 시도합니다.

10번을 다시 테스트 해보면 default 파티션으로 9번이 실행 되었습니다.

1번은 dummy 파티션쪽 서비스를 실행하다가 에러가 난 것입니다.

2번째 실행에서 dummy 파티션의 서비스가 없어서 에러가 나고 3번째 부터는 정상적인 것으로 라우팅을 하게 됩니다.

다시 상태를 봐보면 Offline으로 표시가 되는군요.. 흠...

Service Result Caching

제목에 모든 설명이 다 나와있군요...

처리시마다 조회되는 (하지만 별로 변하지 않는) 서비스는 캐시를 이용해서 처리되는 시간을 단축시켜봅시다!

아래 글미과 같이 A 서비스와 B 서비스와의 결과 값이 항상 같다면 A에서 받은 결과를 캐시에 담아놨다가 B에 요청하려고 하면 캐시에 담아져있는 데이터를 사용하면 되겠습니다. (맞나? -_-)

OSB 콘솔에서 세션을 생성합니다.

System Administration - Import 에서 chap-2B_starting-caching.jar 파일을 입포트합니다.

Import 버튼 클릭.

수정사항을 적용 합니다.

※ 만약 주소나 포트가 틀리면 아래와 같이 Endpoint URI 부분을 수정해줘야 합니다.

Resource Browser 로 이동합니다.

GetPO 선택.

"Message Handling Configuration" 을 수정합니다.

"Advanced Settings"을 확장합니다.

"Result Caching"을 활성화 하고, 시간 간격을 1분으로 서정합니다.

"Cache Token Expression"은 "$body/po:PO_ID" 입력.

Save 버튼 클릭.

POStatus - ProxyServices 에서 "GetPO"의 메세지 흐름을 수정합니다.

"GetPO" 클릭 - "Add Pipeline Pair" 선택

"Response Pipeline" 클릭 - "Add Pipeline Pair" 선택

stage1 클릭 - "Edit State" 선택

"Add an Action" 클릭 - Message Processing - Replace 선택

"variable"에 "header" 입력 후 <Expression> 클릭.

아래와 같이 입력 후 Save 버튼 클릭

<caching-metadata>
<cache-originated>{$outbound/ctx:transport/ctx:response/tp:cache-originated/text()}</cache-originated>
<cache-token>{$outbound/ctx:transport/ctx:response/tp:cache-token/text()}</cache-token>
</caching-metadata>

"Replace node contents" 선택.

"Save All" 버튼 클릭하여 모두 저장 후 수정사항을 적용합니다. (Activate)

테스트 해봅시다.

"2222" 입력 후 Execute 버튼 클릭.

cache-originated^[각주:1] 값이 false 입니다. 캐쉬 데이터가 아니라는 것이죠!

1분 내에 다시 테스트를 해봅니다.

이번에는 캐쉬된 데이터라는군요 ㅎㅎㅎ

Introduction

WebLogic, OSB, SOA 프로그램 설치는 패스 하겠습니다. 특별한거 없으면 "Next" 만 눌러도 설치 가능...

전 버전(11.1.1.2.0): http://antop.tistory.com/58 (실질적으로 같음)

Oracle Weblogic: http://download.oracle.com/docs/cd/E17904_01/doc.1111/e14142/toc.htm

Oracle Service Bus: http://download.oracle.com/docs/cd/E17904_01/doc.1111/e15017/toc.htm

Oracle SOA Suite: http://download.oracle.com/docs/cd/E17904_01/doc.1111/e13925/toc.htm





※ 저는 로컬 컴퓨터에 도저히 SOA 를 못하겠어서 다른 곳(Linux)에 설치하였습니다. ㅠ_ㅠ


Configure Schema (Repository Creation Utility)

rcu 는 데이터베이스에 붙어서 하는 작업이기 때문에 굳이 로컬에서 하지 않아도 됩니다.

※ 만약 데이터베이스가 Oracle XE 일 경우 아래와 같이 환경변수 설정 후 rcu를 실행해야 합니다.

(원문: If you want to use Oracle XE as your database, you need to set the RCU_JDBC_TRIM_BLOCKS environment variable to TRUE *prior* to running RCU.)

입력할 계정은 테이블스페이스, 계정 생성 등등 권한이 있는 계정이어야 합니다.

불행히도 저의 환경은 UTF8이 아니군요.. 이렇게 경고가 나옵니다.

접두어 설정 후 "SOA and BPM Infrastructure" 만 클릭하면 필요한 것까지도 다 선택됩니다.

스키마 비밀번호 설정.

생성 버튼 클릭.

스키마 생성 완료!

Create Domain

$ {ORACLE_HOME}/oracle_common/common/bin/config.sh

아래 그림처럼 3개를 선택합니다. 나머지는 자동 선택됩니다.

도메인 네임 설정.

관리자 계정/비밀번호 설정.

rcu로 만든 스키마를 설정합니다.

공통으로 바꿀 수 있는거는 다같이 선택해서 하면 되고, 따로따로 해야될꺼는 하나씩 선택해서 수정합니다.

마지막 "OSB JMS Reporting Provider"는 Derby 로 되어있는데 아래 그림과 같이 Oracle 디비로 바꿔줍니다.

스키마 테스트에 성공해야 합니다.

이 부분은 나중에 웹로직 콘솔 데이타소스(DataSource)에서 수정할 수 있습니다.

"Administration Server", "Managed Servers, Clusters and Machines" 두가지를 선택.

저는 Admin 서버의 이름과 리스너 포트를 변경하였습니다.

Managed 서버에서 osb_server1 을 삭제하여 어디민에 포함되게 합니다.

그냥 나둬도 되는데.... 분리를 하니까 현재 JDeveloper에서 OSB에서 만든 것(?)들을 불러오지 못하더군요... ㅠ_ㅠ

"soa_server1" 만 남겨두고 Next 클릭. (전 soa_server1 포트를 8011로 변경)

Create 버튼 클릭.

도메인 생성 완료!