/
Working with Registry Artifacts

This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Working with Registry Artifacts

Apr 05, 2018

This page describes how to create artifacts for Registry. It contains the following sections:

Creating a Registry Resource project

Note that registry resources created in WSO2 EI Tooling (and deployed via Composite Applications) will only support the registry aspect and not the governance aspect when used with Registry.

You can save resources such as images, WSDLs, XSLTs in a central repository as registry resources. All these registry resources need to be saved in a separate project called a Registry Resources project. To create a Registry Resources project, follow the steps below.

  1. Open the WSO2 EI Tooling dashboard (click Developer Studio > Open Dashboard) and click Registry Resources Project.

  2. Give a name for the project and click Finish.

     

Creating registry resources

Initially, your registry resources project will contain only a pom file. You can create any number of registry resources inside that project. To create a registry resource, right click on the Registry Resources project and click New > Registry Resource.

There are several ways to create a registry resource. Follow the instructions in the sections below.

From existing template

Use the From existing template option if you want to select a template from which to create a registry resource. 

  1. Select From existing template and click Next.

  2. In the Template field, select a template from the list. In this example, a WSDL file template is used. 

  3. Specify a name for the WSDL file. 

  4. In the Registry Path field, define where you want to save the resource in the registry. 

  5. In the Save Resource in field, select an existing Registry Resource project in which you want to save the resource. Alternatively, you can create a new Registry Resource project. 

     



  6. Click Finish.

  7. Now you will see the WSDL file generated with the specified name and opened in the embedded WSDL editor as shown below.

     

Import from file system

Use the Import from file system option to import a file or a folder containing registry resources.

  1. Click the Import from file system option and click Next.

  2. Click Browse file or Browse folder and browse to the relevant file or folder.

  3. If you browsed to a folder, the Copy content only check box will be enabled. Select the check box if you want to copy only the content of the folder and not the folder itself to the location you specify below.

  4. In the Registry Path to deploy field, specify where the registry resource should be checked-in at the time of deployment. 

  5. In the Save Resource in field, select an existing Registry Resource project in which you want to save the resource. Alternatively, you can create a new Registry Resource project. 

  6. Click Finish.

     

Import Registry dump file from file system

Use this option to browse to a Registry Dump file which you can use to sync a registry. 

  1. Click the Import Registry dump file from file system option and click Next.

  2. Click Browse and browse to the relevant file.

  3. In the Registry Path to deploy field, specify where the registry resource should be checked-in at the time of deployment. 

  4. In the Save Resource in field, select an existing Registry Resource project in which you want to save the resource. Alternatively, you can create a new Registry Resource project. 

  5. Click Finish.

Check-out from registry

  1. Click Check-out from registry and click Next.

  2. Specify the path and artifact name. 

  3. In the Registry Path to deploy field, specify where the registry resource should be checked-in at the time of deployment. 

  4. In the Save Resource in field, select an existing Registry Resource project in which you want to save the resource. Alternatively, you can create a new Registry Resource project. 

  5. Click Finish.

Editing a registry resource

You may need to change the details you entered for a registry resource, for example, the registry path. You can edit such information using the Registry Resource Editor. To open the Registry Resource Editor, right-click on the Registry Resources project and click Registry Resource Editor.

This editor lists all the registry resources that you have defined in that project and it will list the Registry Path to Deploy information per resource.

Creating a registry filter project

  1. Open the WSO2 Ei Tooling dashboard (click Developer Studio > Open Dashboard) and click Registry Filter Project.

  2. Specify the project name, package name and class name. 

  3. A Maven POM file will be generated automatically for this project. If you want to include parent POM information in the file from another project in this workspace, click Next, click the Specify Parent from Workspace check box, and then select the parent project.

  4. Click Finish.

     



  5. A filter class extending the org.wso2.carbon.registry.core.jdbc.handlers.filters.Filter class is created according to the class name you provided. The necessary libraries are added to your class path.

     



  6. If you already have a Composite Application Project created in the workspace, the newly created filter project will also be added to the pom file of the Composite Application Project. If needed, you can create a new Composite Application Project project and select the dependencies.