# Using Route Resources

Available in...

* Cloud API Services Platform
* Cloud Data Fabric
* Data Fabric
* Data Services Platform
* ESB
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

The Route designer allows you to created external Resources that can be used in Routes, for example, an XQuery file for camel-saxon, a WSDL file for camel-cxf, and so on. This section will show you how to create a Route Resource and how to use it in a Route.

## Creating a Route Resource

Available in...

* Cloud API Services Platform
* Cloud Data Fabric
* Data Fabric
* Data Services Platform
* ESB
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

### About this task

To create a new Route resource:

### Procedure

1. In the Repository of the Integration perspective, right-click the Resources node and select Create Resource from the contextual menu.

   ![Create Resource option.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route-create_resource.png)

   The New Resource wizard opens to help you define the main properties of the new Route Resource.

   ![New Resource wizard.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route-new_resource.png)
2. Enter the Resource properties:
   | Field | Description |
   | --- | --- |
   | Source File | The path to a local or remote file to create the Resource<br>from an existing file. |
   | Name | The name of the new Resource. A message comes up if you<br>enter prohibited characters. |
   | Purpose | The purpose of the Resource or any useful information<br>regarding the Resource use. |
   | Description | Resource description. |
   | Author | A read-only field that shows by default the current user<br>login. |
   | Locker | A read-only field that shows by default the login of the<br>user who owns the lock on the current Resource. This field<br>is empty when you are creating a Resource and has data only<br>when you are editing the properties of an existing<br>Resource. |
   | Version | A read-only field. You can manually increment the version<br>using the M and<br>m buttons. For more information,<br>see [Managing Job and Route versions](https://help.qlik.com/talend/en-US/studio-user-guide/8.0/managing-job-and-route-versions). |
   | Status | A list to select from the status of the Resource you are<br>creating. |
   | Path | A list to select from the folder in which the Resource<br>will be created. |
3. Click Finish to create the Resource.

   If you create the Resource from scratch, an empty Resource opens in the editor on the design workspace.

   ![Empty resource in the editor.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route-new_resource1.png)

   If you create the Resource from an existing file, the content of the source file is displayed in the editor on the design workspace.

   ![Resource in the editor.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route-new_resource2.png)
4. Edit the code of your Resource and save it.

## Managing Route Resource versions

Available in...

* Cloud API Services Platform
* Cloud Data Fabric
* Data Fabric
* Data Services Platform
* ESB
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

When you create a Route Resource in the Integration perspective of Talend Studio, by default its version is 0.1 where 0 stands for the major version and 1 for the minor version.

### Procedure

* You can create many versions of the same Route Resource. To do that:
  1. Close your Route Resource if it is open on the design workspace, otherwise, its properties will be read-only and thus you can not modify them.
  2. In the Repository tree view, right-click your Route Resource and select Edit properties in the drop-down list.

     ![Edit properties option.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route_resources-edit_properties.png)

     The Edit properties dialog box is opened.

     ![Edit properties dialog box](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route_resources-edit_properties_dialog.png)
  3. Next to the Version field, click the M button to increment the major version and the m button to increment the minor version.
  4. Click Finish to validate the modification.

  Information noteNote: By default, when you open a Route Resource, you open its last version.
* To change the version of your Route Resource, you can also:
  1. Close your Route Resource if it is open on the design workspace, otherwise, its properties will be read-only and thus you can not modify them.
  2. In the Repository tree view, right-click your Route Resource and select Open another version in the context menu.

     ![Open another version option.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route_resources-open_another_version.png)
  3. In the dialog box, select the Create check box and click the M button to increment the major version and the m button to increment the minor version.

     ![Open another version dialog box.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route_resources-open_another_version_dialog_1.png)
  4. Click Finish to validate the modification and open this new version of your Route Resource.
* You can also save a Route Resource and increment its version in the same time, by clicking File &gt; Save as....

  Information noteNote: This option does not overwrite your current Route Resource. It saves your Route Resource as another new Route Resource with another version.
* You can access a list of different versions of the Route Resource. To do that:
  1. Right-click it in the Repository tree view and select Open another version in the context menu.

     ![Open another version dialog box.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route_resources-open_another_version_dialog_2.png)
  2. Select the version of the Route Resource you want to edit and click Finish to open it in the design workspace.

## Using a Route Resource

Available in...

* Cloud API Services Platform
* Cloud Data Fabric
* Data Fabric
* Data Services Platform
* ESB
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

Once created, you can use the Route Resources in the Mediation components cSOAP and cMessagingEndpoint, and in Spring configuration.

### Procedure

1. To manage the Route Resources in a Route, double-click the Route to open it in the design workspace and click the Dependencies tab to show the Manifest editor.

   ![Manifest editor.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route_manifest_editor.png)
   * To add a Resource, in the Resources area, click Add... and select the Resource you want from tree view in the dialog. Click OK. ![Dialog box to select a Route Resource.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route_resources-manage_route_resources_3.png)

     Once added, you can choose from the different versions of the Resource by clicking the Version field in the Resources table and select the one you want to use from the drop-down list.

     ![Resources table.](https://help.qlik.com/talend/en-US/studio-user-guide/Resources/images/route_resources-manage_route_resources_4.png)

   * To remove a Route Resource from the Route, select it from the list and click Remove. You can not remove a built-in Route Resource.

   * To copy the path of a Route Resource, select it in the table and click Copy Path so that you can use it in the Route.
2. Click OK to validate your modifications.

   Information noteNote: Route Resources used in Routes cannot be deleted from the repository.

   When exporting a Route, the Route Resources that are called in the Route are exported together with the Route into the ESB Runtime KAR file. For more information about how to export Routes, see [Building Routes](https://help.qlik.com/talend/en-US/studio-user-guide/8.0/building-routes).