Rapidminer Server Create Web Services from Process

bhupendra_patilbhupendra_patil Administrator, Employee, Member Posts: 168 RM Data Scientist
edited November 2018 in Knowledge Base


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

Tagged:

Comments

  • kypexinkypexin Moderator, RapidMiner Certified Analyst, Member Posts: 291 Unicorn

    Hi @bhupendra_patil

     

    Quick question about this part: 

     

    Screenshot 2017-10-09 17.54.02.png

     

    As I see here, the generated webservice URL is corresponding to some local host name, and I faced the same thing. 

    Is this a default behaviour for all cases? As obviously the URL should be changed to incorporate an external host name to be used for calling the web service?

     

    Thanks. 

  • bhupendra_patilbhupendra_patil Administrator, Employee, Member Posts: 168 RM Data Scientist

    changehostname.pngchange host name

    You can change that by logging to server as admin and then add a new property and value in System Settings.

    The property is com.rapidanalytics.web.hostname

  • kevin_reifkevin_reif Member Posts: 6 Contributor I

    Another question: How can I call this service like api/rest/public/process with anonymous user?

     

    Thanks in advance and best regards

     

    Kevin Reif

  • sgenzersgenzer Administrator, Moderator, Employee, RapidMiner Certified Analyst, Community Manager, Member, University Professor, PM Moderator Posts: 2,959 Community Manager

    hi @kevin_reif - this docs page has some very good info on anonymous users for RM Server: https://docs.rapidminer.com/latest/server/administration/user-management/special-users.html

     

    Scott

     

Sign In or Register to comment.