WCF 채널 모델에서 SELECT 문을 사용하여 Oracle E-Business Suite 폴링
ORACLE E-Business Suite에서 인터페이스 테이블, 인터페이스 뷰, 테이블 및 뷰를 지속적으로 폴링하는 SELECT 문을 사용하여 주기적인 데이터 변경 메시지를 받도록 Oracle E-Business 어댑터를 구성할 수 있습니다. 어댑터가 Oracle E-Business Suite를 폴링하기 위해 주기적으로 실행되는 폴링 문으로 SELECT 문을 지정할 수 있습니다. 폴링 문이 실행된 후 어댑터가 실행되는 폴링 후 PL/SQL 코드 블록을 지정할 수도 있습니다.
폴링을 사용하도록 설정하려면 이 항목에 설명된 대로 특정 바인딩 속성을 지정해야 합니다. 어댑터가 폴링을 지원하는 방법에 대한 자세한 내용은 폴링을 사용한 인바운드 호출 지원을 참조하세요.
Oracle E-Business Suite 어댑터 바인딩 속성을 사용하여 폴링 작업 구성
다음 표에서는 데이터 변경 메시지를 받도록 어댑터를 구성하는 데 사용하는 Oracle E-Business 어댑터 바인딩 속성을 요약합니다. 폴링 애플리케이션을 실행하는 동안 이러한 바인딩 속성을 지정해야 합니다.
| Binding 속성 | Description |
|---|---|
| InboundOperationType | 폴링 또는 알림 인바운드 작업을 수행할지 여부를 지정합니다. 기본값은 폴링입니다. |
| PolledDataAvailableStatement | 어댑터가 실행되는 SQL 문을 지정하여 폴링에 사용할 수 있는 데이터가 있는지 여부를 확인합니다. 레코드를 사용할 수 있는 경우에만 PollingInput 바인딩 속성에 대해 지정한 SELECT 문이 실행됩니다. |
| PollingInterval | Oracle E-Business 어댑터가 PolledDataAvailableStatement 바인딩 속성에 지정된 문을 실행하는 간격(초)을 지정합니다. 기본값은 30초입니다. 폴링 간격은 연속 폴링 간의 시간 간격을 결정합니다. 문이 지정된 간격 내에 실행되면 어댑터는 간격의 나머지 시간 동안 절전 모드로 유지됩니다. |
| PollingInput | 폴링 문을 지정합니다. SELECT 문을 사용하여 폴링하려면 이 바인딩 속성에 대해 SELECT 문을 지정해야 합니다. 기본값은 null입니다. 폴링을 사용하려면 PollingInput 바인딩 속성에 대한 값을 지정해야 합니다. 폴링 문은 PolledDataAvailableStatement 바인딩 속성에 의해 결정되는 폴링에 사용할 수 있는 데이터가 있는 경우에만 실행됩니다. |
| PollingAction | 폴링 작업에 대한 작업을 지정합니다. 어댑터 서비스 참조 Visual Studio 플러그 인 추가를 사용하여 작업에 대해 생성된 서비스 인터페이스에서 폴링 작업을 확인할 수 있습니다. |
| PostPollStatement | PollingInput 바인딩 속성에 지정된 문이 실행된 후 실행되는 문 블록을 지정합니다. |
| PollWhileDataFound | 폴링되는 테이블에서 데이터를 사용할 수 있는 경우 Oracle E-Business 어댑터가 폴링 간격을 무시하고 폴링 문을 지속적으로 실행할지 여부를 지정합니다. 테이블에서 사용할 수 있는 데이터가 없으면 어댑터가 되돌려 지정된 폴링 간격으로 폴링 문을 실행합니다. 기본값은 false입니다. |
이러한 속성에 대한 자세한 설명은 BizTalk Adapter for Oracle E-Business Suite 바인딩 속성에 대해 읽어보세요. Oracle E-Business 어댑터를 사용하여 Oracle 데이터베이스를 폴링하는 방법에 대한 전체 설명은 이 항목의 나머지 부분을 참조하세요.
이 항목에서 폴링을 보여 주는 방법
이 항목에서는 Oracle E-Business 어댑터가 SELECT 문을 사용하여 데이터 변경 메시지 수신을 지원하는 방법을 설명하기 위해 Application Object Library 애플리케이션의 MS_SAMPLE_EMPLOYEE 인터페이스 테이블을 폴링합니다. 이 테이블은 샘플과 함께 제공되는 create_apps_artifacts.sql 스크립트를 실행하여 Oracle E-Business Suite에서 이러한 개체를 만들 때 만들어집니다.
폴링 작업을 보여 주기 위해 다음을 수행합니다.
PolledDataAvailableStatement 바인딩 속성에 대한 SELECT 문을 지정하여 폴링되는 인터페이스 테이블(MS_SAMPLE_EMPLOYEE)에 데이터가 있는 위치를 결정합니다. 이 예제에서는 이 바인딩 속성을 다음과 같이 설정할 수 있습니다.
SELECT COUNT (*) FROM MS_SAMPLE_EMPLOYEE이렇게 하면 MS_SAMPLE_EMPLOYEE 인터페이스 테이블에 일부 레코드가 있는 경우에만 어댑터가 폴링 문을 실행합니다.
PollingInput 바인딩 속성에 대한 SELECT 문을 지정합니다. 이 문은 MS_SAMPLE_EMPLOYEE 인터페이스 테이블의 모든 행을 검색합니다. 이 예제에서는 이 바인딩 속성을 다음과 같이 설정할 수 있습니다.
SELECT * FROM MS_SAMPLE_EMPLOYEE FOR UPDATE참고
SELECT 문에 사용되는 FOR UPDATE 절에 대한 자세한 내용은 Oracle E-Business Suite에서 폴링 기반 데이터 변경 메시지 받기를 참조하세요.
POSTPollStatement 바인딩 속성의 일부로 DELETE 문을 지정합니다. 이 문은 MS_SAMPLE_EMPLOYEE 인터페이스 테이블에서 모든 데이터를 삭제합니다. 이 예제에서는 이 바인딩 속성을 다음과 같이 설정할 수 있습니다.
DELETE FROM MS_SAMPLE_EMPLOYEE이 경우 다음에 PollingInput 에 지정된 문이 실행될 때 데이터를 가져오지 않습니다.
MS_SAMPLE_EMPLOYEE 인터페이스 테이블에 더 많은 데이터가 추가될 때까지 폴링 메시지가 표시되지 않으므로 새 레코드로 MS_SAMPLE_EMPLOYEE 인터페이스 테이블을 다시 채워야 합니다. 샘플과 함께 제공되는 insert_apps_data.sql 스크립트를 실행하여 수행할 수 있습니다. 이 스크립트를 실행한 후 다음 폴링 작업은 테이블에 삽입된 새 레코드를 가져옵니다.
폴링 요청 메시지 사용
어댑터는 코드에서 폴링 작업을 호출하여 Oracle E-Business Suite를 폴링합니다. 즉, 어댑터는 IInputChannel 채널 셰이프를 통해 수신하는 폴링 요청 메시지를 보냅니다. 폴링 요청 메시지에는 PollingInput 바인딩 속성에 지정된 쿼리의 결과 집합이 포함됩니다. 다음 두 가지 방법 중 하나로 폴링 메시지를 사용할 수 있습니다.
노드 값 스트리밍을 사용하여 메시지를 사용하려면 응답 메시지에서 WriteBodyContents 메서드를 호출하고 노드 값 스트리밍을 구현하는 XmlDictionaryWriter 를 전달해야 합니다.
노드 스트리밍을 사용하여 메시지를 사용하려면 응답 메시지에서 GetReaderAtBodyContents 를 호출하여 XmlReader를 가져올 수 있습니다.
이 항목에 사용된 예제 정보
이 항목의 예제에서는 MS_SAMPLE_EMPLOYEE 인터페이스 테이블을 폴링합니다. 테이블을 생성하는 스크립트는 샘플과 함께 제공됩니다. 샘플에 대한 자세한 내용은 Oracle EBS 어댑터에 대한 샘플을 참조하세요. 이 항목을 기반으로 하는 샘플 SelectPolling_ChannelModel Oracle E-Business 어댑터 샘플도 제공됩니다.
WCF 채널 모델을 사용하여 폴링 작업에 대한 인바운드 메시지 수신
이 섹션에서는 Oracle E-Business 어댑터를 사용하여 인바운드 폴링 메시지를 수신하는 .NET 애플리케이션(채널 모델)을 작성하는 방법에 대한 지침을 제공합니다.
어댑터에서 폴링 메시지를 받으려면
Visual Studio에서 Microsoft Visual C# ® 프로젝트를 만듭니다. 이 항목에서는 콘솔 애플리케이션을 만듭니다.
솔루션 탐색기 , ,
Microsoft.ServiceModel.ChannelsSystem.ServiceModel및System.Runtime.Serialization에 대한 참조를Microsoft.Adapters.OracleEBS추가합니다.Program.cs 파일을 열고 다음 네임스페이스를 추가합니다.
Microsoft.Adapters.OracleEBSSystem.ServiceModelSystem.ServiceModel.DescriptionSystem.ServiceModel.ChannelsSystem.Xml
연결 URI를 지정합니다. 어댑터 연결 URI에 대한 자세한 내용은 Oracle E-Business Suite 연결 URI 만들기를 참조하세요.
Uri ConnectionUri = new Uri("oracleebs://ebs_instance_name");OracleEBSBinding의 instance 만들고 폴링을 구성하는 데 필요한 바인딩 속성을 설정합니다. 최소한 InboundOperationType, PolledDataAvailableStatement, PollingInput 및 PollingAction 바인딩 속성을 설정해야 합니다. 폴링을 구성하는 데 사용되는 바인딩 속성에 대한 자세한 내용은 폴 링을 사용하여 인바운드 호출 지원을 참조하세요.
OracleEBSBinding binding = new OracleEBSBinding(); binding.InboundOperationType = InboundOperation.Polling; binding.PolledDataAvailableStatement = "SELECT COUNT (*) FROM MS_SAMPLE_EMPLOYEE"; binding.PollingInput = "SELECT * FROM MS_SAMPLE_EMPLOYEE FOR UPDATE"; binding.PollingAction = "InterfaceTables/Poll/FND/APPS/MS_SAMPLE_EMPLOYEE"; binding.PostPollStatement = "DELETE FROM MS_SAMPLE_EMPLOYEE";인터페이스 테이블을 폴링하기 때문에 애플리케이션 컨텍스트도 설정해야 합니다. 애플리케이션 컨텍스트 설정에 필요한 애플리케이션 컨텍스트 및 바인딩 속성에 대한 자세한 내용은 애플리케이션 컨텍스트 설정을 참조하세요.
binding.OracleUserName = "<Enter user name here>"; binding.OraclePassword = "<Enter password here>"; binding.OracleEBSResponsibilityName = "<Enter responsibility here>";바인딩 매개 변수 컬렉션을 만들고 자격 증명을 설정합니다.
ClientCredentials credentials = new ClientCredentials(); credentials.UserName.UserName = "<Enter user name here>"; credentials.UserName.Password = "<Enter password here>"; BindingParameterCollection bindingParams = new BindingParameterCollection(); bindingParams.Add(credentials);채널 수신기를 만들고 엽니다. OracleEBSBinding에서 BuildChannelListener<IInputChannel> 메서드를 호출하여 수신기를 만듭니다.
IChannelListener<IInputChannel> listener = binding.BuildChannelListener<IInputChannel>(connectionUri, bindingParams); listener.Open();수신기에서 AcceptChannel 메서드를 호출하여 IInputChannel 채널을 가져와서 엽니다.
IInputChannel channel = listener.AcceptChannel(); channel.Open();채널에서 Receive 를 호출하여 어댑터에서 다음 인바운드 메시지를 가져옵니다.
Message message = channel.Receive();인바운드 작업에서 반환된 결과 집합을 사용합니다. XmlReader 또는 XmlDictionaryWriter를 사용하여 메시지를 사용할 수 있습니다.
XmlReader reader = message.GetReaderAtBodyContents();요청 처리를 완료하면 채널을 닫습니다.
channel.Close()중요
인바운드 작업 처리를 완료한 후 채널을 닫아야 합니다. 채널을 닫지 못하면 코드의 동작에 영향을 줄 수 있습니다.
데이터 변경 메시지 수신이 완료되면 수신기를 닫습니다.
listener.Close()중요
수신기를 닫으면 수신기를 사용하여 만든 채널이 닫히지 않습니다. 수신기를 사용하여 만든 각 채널을 명시적으로 닫아야 합니다.
예제
다음 예제에서는 MS_SAMPLE_EMPLOYEE 인터페이스 테이블을 폴링하는 폴링 애플리케이션을 보여줍니다. PollInput 속성에는 MS_SAMPLE_EMPLOYEE 테이블의 모든 데이터를 읽는 select 문이 포함되어 있으며 post poll 문은 동일한 테이블에서 모든 데이터를 삭제합니다. 폴링 메시지는 에 C:\PollingOutput.xml기록됩니다.
후속 폴링 메시지에는 더 많은 데이터가 MS_SAMPLE_EMPLOYEE 인터페이스 테이블에 추가될 때까지 레코드가 포함되지 않습니다. 샘플과 함께 제공되는 insert_apps_data.sql 스크립트를 실행하여 수행할 수 있습니다. 이 스크립트를 실행한 후 다음 폴링 작업은 테이블에 삽입된 새 레코드를 가져옵니다. 어댑터는 RETURN 키를 눌러 <서비스 호스트를 닫을 때까지 계속 폴링합니다>.
using System;
using Microsoft.Adapters.OracleEBS;
using System.ServiceModel;
using System.ServiceModel.Description;
using System.ServiceModel.Channels;
using System.Xml;
namespace SelectPolling_ChannelModel
{
class Program
{
static void Main(string[] args)
{
Console.WriteLine("Sample started. This sample will poll 5 times and will perform the following tasks:");
Console.WriteLine("Press any key to start polling...");
Console.ReadLine();
IChannelListener<IInputChannel> listener = null;
IInputChannel channel = null;
try
{
TimeSpan messageTimeout = new TimeSpan(0, 0, 30);
OracleEBSBinding binding = new OracleEBSBinding();
binding.InboundOperationType = InboundOperation.Polling;
binding.PolledDataAvailableStatement = "SELECT COUNT (*) FROM MS_SAMPLE_EMPLOYEE";
binding.PollingInput = "SELECT * FROM MS_SAMPLE_EMPLOYEE FOR UPDATE";
binding.PollingAction = "InterfaceTables/Poll/FND/APPS/MS_SAMPLE_EMPLOYEE";
binding.PostPollStatement = "DELETE FROM MS_SAMPLE_EMPLOYEE";
binding.OracleUserName = "<Enter user name here>";
binding.OraclePassword = "<Enter password here>";
binding.OracleEBSResponsibilityName = "<Enter responsibility here>";
Uri ConnectionUri = new Uri("oracleebs://ebs_instance_name?");
ClientCredentials credentials = new ClientCredentials();
credentials.UserName.UserName = "<Enter user name here>";
credentials.UserName.Password = "<Enter password here>";
BindingParameterCollection bindingParams = new BindingParameterCollection();
bindingParams.Add(credentials);
listener = binding.BuildChannelListener<IInputChannel>(ConnectionUri, bindingParams);
listener.Open();
channel = listener.AcceptChannel();
channel.Open();
Console.WriteLine("Channel and Listener opened...");
Console.WriteLine("\nWaiting for polled data...");
Console.WriteLine("Receive request timeout is {0}", messageTimeout);
// Poll five times with the specified message timeout
// If a timeout occurs polling will be aborted
for (int i = 0; i < 5; i++)
{
Console.WriteLine("Polling: " + i);
Message message = null;
XmlReader reader = null;
try
{
//Message is received so process the results
message = channel.Receive(messageTimeout);
}
catch (System.TimeoutException toEx)
{
Console.WriteLine("\nNo data for request number {0}: {1}", i + 1, toEx.Message);
continue;
}
// Get the query results using an XML reader
try
{
reader = message.GetReaderAtBodyContents();
}
catch (Exception ex)
{
Console.WriteLine("Exception :" + ex);
throw;
}
XmlDocument doc = new XmlDocument();
doc.Load(reader);
using (XmlWriter writer = XmlWriter.Create("C:\\PollingOutput.xml"))
{
doc.WriteTo(writer);
Console.WriteLine("The polling response is saved at 'C:\\PollingOutput.xml'");
}
// return the cursor
Console.WriteLine();
// close the reader
reader.Close();
message.Close();
}
Console.WriteLine("\nPolling done -- hit <RETURN> to finish");
Console.ReadLine();
}
catch (Exception ex)
{
Console.WriteLine("Exception is: " + ex.Message);
Console.ReadLine();
if (ex.InnerException != null)
{
Console.WriteLine("Inner Exception is: " + ex.InnerException.Message);
Console.ReadLine();
}
}
finally
{
// IMPORTANT: close the channel and listener to stop polling
if (channel != null)
{
if (channel.State == CommunicationState.Opened)
channel.Close();
else
channel.Abort();
}
if (listener != null)
{
if (listener.State == CommunicationState.Opened)
listener.Close();
else
listener.Abort();
}
}
}
}
}