Calling SOAP APIs with SOAP Services

Creating a SOAP Service

You can directly import the WSDL file provided by a third-party system to create a SOAP service, or manually create a SOAP service.

• Method 1: Manually creating a SOAP service

  You have obtained the version, URL, and input parameter format of a SOAP service from the third-party.

  1. Log in to the application designer by referring to Logging In to the Application Designer.
  2. In the navigation pane, choose Integrations.
  3. In the Connector area, click Connector Instance. The connector instance page is displayed.
  4. Choose Type > HTTP > Soap Service.
  5. Click and choose New. The page for creating a SOAP service is displayed.
  6. Configure the connector information and click the save button.
     Figure 1 Configuration page
     

     Table 1 Basic information parameters

     Area	Parameter	Description
     Basic information	Label	Label name of the new SOAP service. Value: 1–64 characters.
     	Name	Name of the new SOAP service, which uniquely identifies the SOAP service in the system. The naming requirements are as follows: The value cannot exceed 64 characters, including the prefix namespace. To prevent duplicate data names among different tenants, each tenant must define a unique namespace when first creating an application. A tenant can create only one namespace. After being created, the namespace cannot be modified. Start with a letter and can contain only letters, digits, and underscores (_). Do not end with an underscore (_).
     	Address	URL of the SOAP service.
     	SOAP Version	SOAP version.
     	Date Format	If the input parameters of the SOAP service include a parameter of the Date type in a specified format, this parameter is mandatory. Ensure that the input parameters provided by Huawei Cloud Astro Zero meet the third-party requirements. For example, if the SOAP service has an input parameter of the Date type and the format is YYYY-MM-DD, set this parameter to YYYY-MM-DD.
     	Date/Time Format	However, if the input parameters of the SOAP service include a parameter of the DateTime type in a specified format, this parameter is mandatory. Ensure that the input parameters provided by Astro Zero meet the third-party requirements. For example, if the SOAP service has an input parameter of the DateTime type and the format is YYYY-MM-DD hh:mm:ss, set this parameter to YYYY-MM-DD hh:mm:ss.
     	Description	Description of the service.
     Namespace	Name	Name of the namespace in the SOAP service.
     	Namespace	Set it to the value of targetNamespace in the WSDL file.
     	Description	Enter the description of the namespace as required.
     	Operation	Click or in the Operation column to copy or delete a namespace.
     Operation Info	Name	Name of the operation allowed by the third-party system. Set it to the value of operation name in the WSDL file.
     	Operation	Click or in the Operation column to copy or delete an operation.

• Importing the SOAP package

  You can import a WSDL file to Huawei Cloud Astro Zero, which then will automatically generate a SOAP service. You have obtained a WSDL file from a third-party and have compressed it into a ZIP package.

  1. Log in to the application designer by referring to Logging In to the Application Designer.
  2. In the navigation pane, choose Integrations.
  3. In the Connector area, click Connector Instance. The connector instance page is displayed.
  4. Choose Type > HTTP > Soap Service.
  5. Click and choose Import. The page for importing the SOAP package is displayed.
  6. Set basic information, select the compressed .zip file in the Choose File area, and click Import.
     Figure 2 Importing the SOAP package
     

     Table 2 Parameters for importing the SOAP package

     Parameter	Description
     File Name	Name of the WSDL file to be imported. The value must be the same as that of the WSDL file provided by the third-party system.
     Category	Category of the structure generated after the SOAP service is imported. You can enter a name to create a category or select a category from the drop-down list box.
     Date Format	However, if the input parameters of the SOAP service include a parameter of the Date type in a specified format, this parameter is mandatory. Ensure that the input parameters provided by Huawei Cloud Astro Zero meet the third-party requirements. For example, if the SOAP service has an input parameter of the Date type and the format is YYYY-MM-DD, set this parameter to YYYY-MM-DD.
     Date/Time Format	However, if the input parameters of the SOAP service include a parameter of the DateTime type in a specified format, this parameter is mandatory. Ensure that the input parameters provided by Huawei Cloud Astro Zero meet the third-party requirements. For example, if the SOAP service has an input parameter of the DateTime type and the format is YYYY-MM-DD hh:mm:ss, set this parameter to YYYY-MM-DD hh:mm:ss.
     Choose File	Click and add the WSDL file provided by the third party.

Creating and Enabling SOAP Actions

You can add actions for a SOAP service to transform third-party APIs into a format recognizable by Huawei Cloud Astro Zero. This allows Huawei Cloud Astro Zero to call third-party APIs effectively.

1. Log in to the application designer by referring to Logging In to the Application Designer.
2. In the navigation pane, choose Integrations.
3. In the Connector area, click Connector Instance. The connector instance page is displayed.
4. Choose Type > HTTP > Soap Service.
5. On the Action tab page, click New.
   Figure 3 Creating SOAP actions
   

   Table 3 Parameters for creating SOAP actions

   Area	Parameter	Description
   Basic information	Label	Label of the new SOAP action. Value: 1–64 characters.
   	Name	Name of the new SOAP action, which uniquely identifies the action in the system and cannot be changed after being created. The naming requirements are as follows: The value cannot exceed 64 characters, including the prefix namespace. To prevent duplicate data names among different tenants, each tenant must define a unique namespace when first creating an application. A tenant can create only one namespace. After being created, the namespace cannot be modified. Start with a letter and can contain only letters, digits, and underscores (_). Do not end with an underscore (_).
   	SOAP Operation	SOAP operation to be called. The parameter is set when the SOAP service is created. Set it to the value of operation name in the WSDL file.
   	Action Interface	Set it to the value of soapAction in the WSDL file.
   	Description	Enter the action description as required.
   Input Parameters/Output Parameters	Label	Label of the new parameter.
   	Name	Name of the new parameter, which uniquely identifies the parameter in the system.
   	Data Type	Data type of the parameter. Select a value from the drop-down list. Date: The value is accurate to day. Date/Time: time type, accurate to second. Number String Boolean: The value is true or false. Global structure
   	Namespace	If the data type is set to global structure, you need to set the namespace to which the parameter belongs.
   	Struct Type	If the data type is set to global structure, you can use either a system-provided or a custom type.
   	Description	Enter the description of the parameter.
   	Required	Indicates whether the new parameter is mandatory.
   	Collection	Whether the new parameter is set to the array type.
   	Operation	Click or to copy or delete the parameter.

6. On the Action tab page, click in the row where the action is located to enable the action.

Using a Flow to Call an Action

Create a flow. Then, use the flow to call the actions added to the SOAP service to integrate the service functions provided by the third party into Huawei Cloud Astro Zero.

1. Log in to the application designer by referring to Logging In to the Application Designer.
2. In the navigation pane, choose Logic.
3. Click next to Flow. On the displayed dialog box, specify the flow label and name and click Add.
   Figure 4 Adding a flow
   

4. On the navigation pane of the flow designer page, choose Connector > Soap Service > Service name and drag the SOAP service icon to the canvas.
5. Set basic information about the SOAP action.
   Figure 5 Setting basic information
   

   Table 4 Basic information parameters

   Parameter	Description
   Label	Name of a diagram element displayed on the page.
   Name	Unique ID of the diagram element in the system, which cannot be changed after being created. Value: 1–80 characters.
   Description	Enter the diagram element description as required.
   SOAP Service	SOAP service name. Select the name created in Creating a SOAP Service.

6. Set the parameters for calling the SOAP action.
   Figure 6 Configuring an action
   

   Table 5 SOAP action parameters

   Parameter	Description
   Action	Select the action created in Creating and Enabling SOAP Actions.
   Input Parameters	Click Add Row to set input parameters. In Target, select the input parameter set in 5 and set the corresponding value in Source.
   Output Parameters	Click Add Row to set output parameters. In Target, select the output parameter set in 5 and set the corresponding value in Source.

7. Click in the upper part of the flow designer page to save the flow.
8. Click to activate the flow.
9. In the input parameter area, enter the request parameters, click Run, and view the output result.