Creating XML Schema Activity

The XML Schema activity defines the procedure to read data from and write data to an XML file. You can do that by specifying the schema definition location.

To create an XML schema:

1. Go to Develop > Services > Schema > XML.

2. Click XML Schema.

   

    

3. On the New XML Schema window, type the name and description for new XML Schema in the Name and Description.

   

   
   

4. Click Validate XML check box to validate the XML against an XSD file during execution. It works only when you use an XSD file to create an XML schema activity. In addition, this schema activity must be used in the process flow (which is generally not required in case of XML format). This option validates the entire XML at runtime.

   It is recommended to use XML Validator Activity in case you want to validate any portion of the XML stream.

   If you want to validate and process large XML files using Saxon parser for all XML Schema activities created in Adeptia Suite then you need to set the value Saxonica in the abpm.xml.validator.engine property (.../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel/etc/server-configure.properties file). For a particular activity, you can set the value (Native or Saxonica) in the XML Validator field in the Advanced Properties.

5. Select one of the following Definition Modes - Import File, Web Service Consumer, Web Service Provider, and Web Form.
6. Depending on the option chosen in the Definition modes, the further steps differ.
   If you have selected Import File option then
   1. If your XSD file is referring to another XSD file then you can either choose an existing file reference activity from the File References drop-down list or create a new file reference activity by clicking . You can update an existing file reference activity by clicking . Click here to know how to create a new file reference activity.
   2. Browse to and select the XSD file in the File Path. 
   3. Click Validate XSD to validate the path of the file in the File Path. You can validate all XML, XSD, or DTD files with this validator. If it is not an XSD file then the schema will convert it to an XSD file format and then validate.
   If you have selected Web Service Consumer option then 
   1. Select the pre-defined Web Service Consumer activity from the Consumer ID.
   2. Select from the following options the XSD type - Input, Output, and Header.
      
   If you have selected Web Service Provider option then 
   1. Select the pre-defined Web Service Provider activity from the Provider.
   2. Select from the following options the XSD type - Input and Output.

   If you have selected Web Form option then select the web form. 
    

   You will find all the items in the Consumer ID and Provider drop-down lists that you have created using WSDL4j parser. All the Consumer and Provider activities that you have created using the new parser (Easy WSDL) are directly loaded into the Data Mapper.

   Earlier due to the limitations of old XSD parser (CASTOR), you could not load XML Schema for certain types of XSD. As a workaround, you have to modify the XSD file. Adeptia Suite now has a new XSD parser (Easy Schema parser) which overcomes this problem. The Easy Schema parser also improves the performance when there are a lot of referential XSDs.

   Adeptia Suite provides interoperability between CASTOR and Easy Schema parser. You just need to edit and save an activity using the parser that you want to use. 

7. Expand Advanced Properties.

   

8. Type the XML validator name to parse the XML file in the XML Validator. The value can be Native or Saxonica.

9. Click Convert XML/DTD to XSD check box to instruct the schema to convert the entire XML/DTD to XSD.

10. Click here to know about other fields.

11. Click Save.

Updating Existing XML Schema Activity Using Easy Schema Parser

When you upgrade your existing XML schema activity by using the new parser (Easy Schema Parser) then your mapping may be lost during the process. For example, if you have an XSD file that has namespaces then it is possible that the namespace prefix may change when you update the existing XML schema activity by using the new parser. In this case, the mapping can be lost and you may have to repeat the mapping process.

You need to follow these steps to ensure that there are no structural changes in your mapping:

1. Create a new XML schema activity using the same XSD file.
2. Load both the XML schema activities (exiting and new) into the data mapper.
3. Verify their hierarchy

If you want to update your existing XML Schema activity by using the new parser (Easy Schema Parser) then follow the below steps:

1. Go to Develop > Services > Schema > XML.
2. Click an existing activity name that you want to parse using the Easy Schema parser.

3. Expand Advanced Properties and then click XML Schema Version 2.0 check box.

   
   

   
   

4. Click Save.

   The Help link beside the XML Schema Version 2.0 check box provides you with some additional information about the parser.