Web Service Composite Generator
This wizard is used to generate a component that accesses a Web Service.
The following steps will guide you through the Web Service wizard:
-
Access the composite generators by following the Main Wizard Module steps.
-
In the Component Details dialog box opens, set the information regarding the component interface:
|
|
|
|
Component Type
|
This property displays the selected composite type from the previous screen.
|
|
Component Name
|
This property is mandatory. If you invoked the generator from the CRR, the name is fetched from the CRR entry that you are parked on.
|
|
Component Location
|
This property specifies the location in which the export files and the cabinet file will be saved in. You can browse to select a directory.
|
|
Cabinet File Name
|
This property specifies the name of the created cabinet file. The default name is based on the component name.
|
-
Click the Details button to add additional details about the component that you are about to create. Click OK.
-
Click the Advanced button to set advanced properties for the component and then click OK.
|
|
|
|
Load Immediate
|
When this property is selected, the component is loaded immediately when the application is opened. For a Web Service component, the wizard creates a Developer function, which must be loaded immediately to be available for use. Therefore, for a Web Service component, this property is selected and disabled.
|
|
Interface File Name and Location
|
If the Save Interface File property is selected, you can specify the name and path of the interface file.
|
|
Save Project Files
|
You can determine if the project's files will be saved at the end of the component generation process. If you do not select this option, the project file is not created. If you decide not to save the project files, you will not be able to modify the component to fit your own needs.
|
|
Add as Module to Project
|
If you chose to save the project files, then you can select this check box if you want the new created project to be added to the current project as a module.
|
-
In the Web Service Location screen, click the WSDL URL or UDDI Search option. If you selected WSDL URL, enter the location of the WSDL. You can enter up to 256 characters in the WSDL URL field. You can click the Browse button to search for the WSDL file on the disk.
-
Click Next and Magic xpa will access and parse the WSDL file. If a WSDL file is not found or if the WSDL file is invalid, an error message will appear.
If you selected the UDDI Search option, the UDDI Server and Search String screen will appear. If you selected the WSDL URL option, the Add Operations screen will appear.
-
In the UDDI Server and Search String screen, enter the UDDI server and a search string to look for a service. The search string should use % as a wildcard character, since this is the most commonly used in the UDDI servers.
-
In the Service Selection screen, select the service that you want to use. This screen displays the services that were found matching the search string. Only services that have a WSDL file (access point) are displayed in the list. The following data will be displayed about the service: company name, service description, and WSDL file.
-
Click Next and the Add Operations section will appear with a list of operations that were found in the WSDL. Select the operations that you want to use. You must select at least one operation.
Note: If there are no operations defined in the WSDL file, the wizard will return to the Web Service Location screen.
-
Click Next and the Modify the Arguments screen appears. This screen displays the data type mappings between the WSDL type and the Magic xpa type. You can edit the argument picture of each field found in the selected operation.
-
Click Next and then Finish to create a Web Service application (component).
To see what happens once you finish using the Web Service wizard, see the Generated Web Service Component topic.
