Using SOAP and Web Services with Ensemble - InterSystems ...

More documents

Recommendations

Info

Creating an Ensemble Web Client• Supporting classes as needed to define XML types and Ensemble messages.The following figure shows how the business operation, adapter, and proxy client class work together.Supporting classes are not shown here.In the preceding figure, all items within dashed lines can be generated by the SOAP client wizard inStudio. You can then edit this code as needed.For a more detailed look at these parts, see “Ensemble Support for Web Clients,” earlier in this book.28 Using SOAP and Web Services with Ensemble
Basic Steps3.2 Basic StepsThis section outlines the basic steps to create an Ensemble Web client. The steps include developmenttasks and then configuration tasks.3.2.1 Development TasksImportant:InterSystems recommends that you do not place custom code or data in the systemprovidednamespaces ENSLIB or ENSDEMO where it will be deleted the next timeyou upgrade Ensemble. The ENSEMBLE namespace and any new namespace thatyou create to hold your work is preserved across Ensemble upgrades.To create an Ensemble Web client, do the following within Studio:1. Use the SOAP client wizard to generate the business operation class, proxy client class, and supportingclasses. This tool is described in the next section of this chapter.2. Check whether you need to adjust the types of the inputs and outputs of the methods. In particular,if any of the methods of the Web service have inputs or outputs that could exceed 32K in length,and if you have not enabled support for long strings in Ensemble, you should change the types ofthose inputs or outputs to an appropriate stream class.3.2.2 Configuration TasksTo add your Ensemble Web client to an Ensemble production, use the Ensemble Management Portalto do the following:1. Add an instance of your custom business operation class to the Ensemble production, specificallythe business operation class generated by the SOAP client wizard.2. Enable the business operation.3. Specify appropriate values for the runtime settings of the associated adapter(EnsLib.SQL.OutboundAdapter), as discussed later in this chapter.4. Run the production.If you are not familiar with the Ensemble Management Portal, see the appendix “Common Tasks inthe Ensemble Management Portal” for information on these tasks.Using SOAP and Web Services with Ensemble 29
Page 1 and 2: Using SOAP and WebServices with Ens
Page 3 and 4: Table of ContentsAbout This Book ..
Page 5: List of TablesBasic Web Service Par
Page 9 and 10: 1About SOAP and Web ServicesEnsembl
Page 11 and 12: 1.2 Ensemble Support for Web Client
Page 13 and 14: Ensemble Support for Web ClientsAs
Page 15 and 16: 2Creating an Ensemble Web ServiceTh
Page 17 and 18: Basic RequirementsCommunication wit
Page 19 and 20: • The class can optionally implem
Page 21 and 22: Method OnProcessInput(pInput As %Re
Page 23 and 24: Implementing the OnProcessInput Met
Page 25 and 26: 2.4.3 Using the SendRequestAsync Me
Page 27 and 28: Example2.6 ExampleThe following sim
Page 29 and 30: Creating a Switch in OnProcessInput
Page 31: • Changing the encoding style of
Page 36 and 37: Creating an Ensemble Web Client3.3
Page 38 and 39: Creating an Ensemble Web Client3.4
Page 40 and 41: Creating an Ensemble Web ClientFor
Page 42 and 43: Creating an Ensemble Web Client}}
Page 44 and 45: Creating an Ensemble Web ClientXDat
Page 46 and 47: Creating an Ensemble Web Client•
Page 49 and 50: ACommon Tasks in the EnsembleManage
Page 51: For detailed descriptions, see the
Page 54 and 55: Customizing Startup and TeardownOnP
Page 57 and 58: CUsing the SOAP Inbound AdapterThe
Page 59 and 60: C.4 Settings of the Inbound Adapter
Page 62 and 63: EnsLib.SOAP.OutboundAdapterusing, 3
Page 64: WebServiceClientClass setting, 32We

Using SOAP and Web Services with Ensemble - InterSystems ...

Create successful ePaper yourself

Delete template?

Save as template?