Using SQL Adapters with Ensemble - InterSystems Documentation

Using the SQL Inbound Adapter2.2.1 Development TasksIn the Ensemble Studio, write and compile a new business service class. The following list describesthe basic requirements:• Your business service class should extend Ens.BusinessService.• In your class, the ADAPTER parameter should equal EnsLib.SQL.InboundAdapter.• Your class should implement the OnProcessInput method, as described in “Implementing theOnProcessInput Method.”• Your class can optionally implement any or all of the startup and teardown methods: OnInit,OnTearDown, OnProductionStart, and OnProductionStop. Most commonly, you customizeOnInit; see “Initializing the Adapter.”The following example shows the general structure that you need:Class ESQL.NewService1Extends Ens.BusinessService [ ProcedureBlock ]{Parameter ADAPTER = "EnsLib.SQL.InboundAdapter";Method OnProcessInput(pInput As EnsLib.SQL.Snapshot,pOutput As %RegisteredObject) As %Status{set tsc=$$$OK//your code hereQuit tsc}}Note:The Ensemble Studio provides a wizard that you can use to create a stub similar to the preceding.To access this wizard, click File —> New and then click the Production tab. Note thatthe wizard provides a generic input argument. If you use the wizard, InterSystems recommendsthat you edit the method signature to use the specific input argument needed with this adapter;the input argument type should be EnsLib.SQL.Snapshot.2.2.2 Configuration TasksTo add your business service to an Ensemble production, use the Ensemble Management Portal to dothe following:1. Add an instance of your custom business service class to the Ensemble production.2. Enable the business service.3. Set the PoolSize setting to 1.If PoolSize is larger than 1, the adapter will process many records twice.8 Using SQL Adapters with Ensemble