RapidMiner

Rapidminer Server Create Web Services from Process

by RMStaff ‎06-15-2016 05:29 AM - edited ‎06-15-2016 05:38 AM


RapidMiner Server provides a powerful capability to expose any workflow you built to be converted into a webservices within a matter of few clicks. 

 

This section describes how to expose a RapidMiner Server process as a web service which can be called from other application environment. RapidMiner web services can be either parameterless or can accept parameters as part of the URL query. This article covers parameterless configuration, a follow on article will cover passing parameters and advanced configuration

 

Prerequisites 

  • You will need RapidMiner Server installed  and configured
  • Studio client connected to a server Repository.
  • The process you will want to be available as a web service should be saved in a server repository folder.
  • Any webservice can return data only from the first "res" (Result) port. So ensure the process is designed so that data you expect from the webservice is delivered to first "res" port

This method does not provide ability to create a unique service id, but creates a service id automatically from the name of the underlying process.

If you need to create a unique service id, please refer to link here.

 

port delivery.png

 

Steps

    1. In your studio client navigate to the process you wish to make available as webservice. 
    2. Right click on the process that you want to expose as web service in your repository panel and click on the "Browse" optionbrowsertoserver.png
    3. This will take you to the server interface for RapidMiner Server. If prompted for username and password provide the appropriate username and password and login. You will be automatically directed to the right page like belowrepobrowser.png
    4. Ensure that the process path (marked 1) above is correct
    5. Click on the "Export as service" (marked 2) above and you should be directed to a screen like below

selectformat.png

    1. Ensure path looks correct in DataSource (Marked 1)
    2. Select the outputformat(Marked 2)
    3. Select the correct MIME Type (Marked 3)
    4. Hit Submit(Marked 4) to save the process . We will cover the other options visible in this panel in a different article
    5. Find the service you created in the next panel by scrolling thru the list of available services
      1. 2016-06-14 21_44_25-Start.pngYou can edit the service by click the edit icon(Marked 1)
      2. You can delete the service by clicking the delete icon(Marked 2)
      3. You can test the service by clicking the test icon (Marked 3)
    6. Click on the test icon and you should see a screen like below

geturl.png

 

  1. You can then test using the “Test” button. (Marked 1)
  2. The link for calling the web service is also available (Marked 2).
  3. The test results should be available in preview section (Marked 3)

 

You can now use the Direct Link(Marked 2) to call a Rapidminer process from other applications

In the next article here we will cover how to pass parameters and some of the advanced parameters