--- parser: v2 auto_validation: true author_name: Robert Waywell author_profile: https://github.com/RobWaywellSAP primary_tag: products>sap-hana-streaming-analytics tags: [ tutorial>intermediate, topic>internet-of-things, products>sap-hana-streaming-analytics, products>sap-hana\,-express-edition ] slug: hsa-java-toolkit-adapter-part4 canonical_url: https://developers.sap.com/tutorials/hsa-java-toolkit-adapter-part4 --- # Editing Adapter Configuration Files Edit a set of adapter configuration files in order to make the custom adapter available to both the HANA Streaming Analytics server at run time and in HANA Studio at design time. ## Prerequisites - **Tutorial:** [Creating Custom Adapter Configuration Files](https://developers.sap.com/tutorials/hsa-java-toolkit-adapter-part3.html) ## Next Steps - [Where to Place the Custom Adapter Files](https://developers.sap.com/tutorials/hsa-java-toolkit-adapter-part5.html) ## You will learn - Locate which files to edit locally on HANA Studio and on the Streaming Server - How to edit the `modulesdefine` and `custommodulesdefine` `.xml` files - How to edit the `parametersdefine.xml` file - To transfer the files edited on the Streaming Server to the client where the HANA Studio is running ## Time to Complete **15 Min** --- ## Intro > **IMPORTANT!** Since you're running a `multidb` SAP HANA environment, `$STREAMING_CUSTOM_ADAPTERS_HOME` will refer to

 `/hana/shared/````/streaming/cluster/````/adapters`

assuming you have used the default location of `/hana` as the root directory for the installation. For this step, we will be adding our custom modules to the `modulesdefine.xml` file and `custommodulesdefine.xml` file, and adding parameter definitions from the `.cnxml` file to `parametersdefine.xsd`. The `modulesdefine.xml` file is located in the `$STREAMING_HOME/adapters/framework/config` directory, the `custommodulesdefine.xml` file is located in the `$STREAMING_CUSTOM_ADAPTERS_HOME/config `directory, and the `parametersdefine.xsd` is located in the `$STREAMING_CUSTOM_ADAPTERS_HOME/config` directory. We are not creating these files from scratch. The purpose of the `modulesdefine.xml` file is to define our custom modules (`Transporter` and `Formatter`) so HANA Streaming Analytics knows what they do and where they reside. The `parametersdefine.xsd` file simply defines what elements are valid in an `adapter_config.xml` file (adapter configuration file). Since we have used a custom element – `MqttInputTransporterParameters` – in our `adapter_config.xml` file, we must define it in `parametersdefine.xsd`. ### Edit modulesdefine.xml and custommodulesdefine.xml > The full source code for the `modulesdefine.xml` and `custommodulesdefine.xml` files are provided in the `Appendix` Section 1. Open `modulesdefine.xml` in a text editor. 2. We will add our Transporter module to the `TransporterDefnList` - Create a `` element. ```XML ``` - Create a `` element. Specify the name of our custom Transporter class. ```XML MqttTransporter ``` - Create a `` element. ```XML com.sap.MqttTransporter ``` - Create an `` element. ```XML String ``` - Close off the `` element. ```XML ``` 3. We will add our formatter module to the `formatterDefnList` - Create a `` element. ```XML ``` - Create a `` element. Specify the name of our custom `Transporter` class. ```XML MqttFormatter ``` - Create a `` element. ```XML com.sap.MqttFormatter ``` - Create an `` element. ```XML String ``` - Create an `` element. ```XML Esp ``` - Close off the `` element. ```XML ``` 4. Repeat steps 1 to 3 for `custommodulesdefine.xml`. For the question below, select the correct answer, and click **Validate**. ### Edit parametersdefine.xsd > The full source code for the `parametersdefine.xsd` file is provided in the `Appendix` Section 1. Open `parametersdefine.xsd` in a text editor. 2. Add the following line to the `` element ```XML ``` 3. Since we have defined the `MQTTInputTransporterParameters` type to be `MQTTInputTransporterParametersDefn`, we must now set up a rule for it. - Create a element and specify the name attribute. ```XML ``` - Create an `` element. - Create an `` element for each `MQTTInputTransporterParametersDefn` parameter (`Topic` and `MosquittoServerAddress`) and specify name and type attributes for each. ```XML ``` - Close off the `` and `` elements. ```XML ``` ### Appendix `modulesdefine.xml` > This is not the full markup of the file. Open your `modulesdefine.xml` file in a text editor and add the `TransporterDefn` and `FormatterDefn` elements of the markup shown below. ```XML … … MqttTransporter com.sap.MqttTransporter String … … MqttFormatter com.sap.MqttFormatter String ESP … ``` `custommodulesdefine.xml` > This is not the full markup of the file. Open your `custommodulesdefine.xml` file in a text editor and add the `TransporterDefn` and `FormatterDefn` elements of the markup shown below. ```HTML … … MqttTransporter com.sap.MqttTransporter String … … MqttFormatter com.sap.MqttFormatter String ESP … ``` `paramtersdefine.xsd` > This is not the full markup of the file. Open your `custommodulesdefine.xml` file in a text editor and add the `xs:element` and `xs:complexType` elements of the markup shown below. ```HTML … … … … ```