When developing SOA based applications, you often have the need to use and communicate with existing services. The Morphyc architecture makes this easy to do through its native support for different type of XML based communication.
If the service that you are using provides a WSDL (Web Services Description Language) definition file, then communicating with this service is made even easier through the Import Service process.
This process examines the selected WSDL file and generates the required runtime patterns needed to call the defined services. This includes configuring a Web Service Proxy containing the location information of the remote service, and an Access Service
containing rules to ensure correct messages are sent to the service.
It is this Access Service
node that should be called from your rules when required, as this contains logic to ensure the correct SOAP structure is present if required, to determine which action should be called on the remote service, and to detect success or failure responses.
Clicking the Import Service button from the Project Screen will show a screen like the following:
Select the WSDL file that defines the service you want to use. This is done by selecting the Select WSDL file to import link which should open a Repository Viewer window which can be used to upload and select your WSDL file. You can also use the Upload From URL tab to load the WSDL from its web location directly. Please see the section on Asset Management for more details.
Once all the details have been entered, you can click Next to perform the import process. This should parse the selected WSDL file and generate the required components. Once completed, you should see a success message, and a link to return to the Project Screen, which will now show two entries for the generated runtime patterns in your chosen layer.
If for any reason the WSDL file could not be parsed correctly, you will be given a list of all the errors found. These will need to be corrected before the import process can be completed for the given WSDL.
If the selected WSDL file was parsed before of there are unforeseen name conflicts then XDE will prompt you for a Name Prefix value to ensure that the names given to the generated components will not conflict. The value entered will be prefixed to the generated names found from inspecting the WSDL file. Any text string can be entered, but we would recommend keeping it to just a few characters.