Skip to content

Overview

Development

Overview

IDEs

API Explorer

Service Picker

Introduction

The Service Picker is a GUI component shown when choosing a service, hence its name. The Service Picker is displayed when selecting a service to be called by an endpoint when it is triggered, a package during startup or shutdown, a Gloop API endpoint, and more.

Service Picker

Service Picker

Before displaying the list of selectable services, TORO Integrate will inspect all services first, and filter those that are compatible with the feature you are trying to use. In most cases, TORO Integrate compares the names and types of variables in your services against the names and types of parameters that the endpoint or functionality supports. If a service has a parameter whose name and type does not match the endpoint or functionality, it will not be included in the list.

The service you select from the Service Picker will be highlighted and a preview of that service's documentation (from) its comments) will be shown at the bottom panel. As seen in the screenshot above, Markdown is honored and rendered.

Demonstration

To show the Service Picker in action, you can create a directory watcher endpoint that uses a Gloop service.

  1. Right click the code directory of an Integrate package and select New > Gloop Service. Use WatcherService as the name of the service and click Finish.
  2. Right click Endpoints and select New > Integrate Endpoint. Select Directory Watcher as the type of the endpoint and use watcher as its name then click Finish.
  3. After creating the endpoint, the endpoint configuration page should show up. To show the Service Picker, click the Choose… button beside the Service field.

The Service Picker will be shown displaying the list of services that are compatible with your directory watcher endpoint. You should be able to see WatcherService on the list.

Show hidden services?

Some Java or Groovy methods are not visible in the Service Picker by default. These kinds of methods are called advanced services. A method is considered advanced if it is any of the following:

  • A method of java.lang.Object
  • A synthetic method
  • A method signature containing $
  • Annotated with io.toro.integrate.core.service.annotation.ESBAdvanced

To view these hidden services, tick the Show hidden services checkbox.

Creating a New Service from the Service Picker

Beginning Coder Studio v1.5, you can create a new Flux, Gloop or Groovy service straight from the Service Picker using the New Service wizard. To create a service using this method:

  1. Click the New... button located at the bottom part of the Service Picker.
  2. Enter the name of your service.
  3. Select the type of service you want to create.
  4. Click the Next button.
  5. Select the properties that you want to use as inputs of your service.
  6. Click Finish.

Creating a new service via the Service Picker