Introduction the Watson Developer Cloud for Application Builder Administrators
IBM Watson Explorer combines search and content analytics with unique cognitive computing capabilities offered by the Watson Developer Cloud to help users find and understand the information they need to work more efficiently and make better, more confident decisions. Watson Explorer Application Builder is the delivery tool that allows developers to quickly construct a 360-degree view combining data and analytics from many sources into a single view. These applications can be enhanced using content from external sources, external visualization libraries (such as D3.js), and external APIs. Integrating with the Watson Developer Cloud provides opportunities for further enhancing Watson Explorer applications to include cognitive-based features. Watson Developer Cloud applications can be integrated with Watson Explorer in a number of ways depending on the use cases and desired functionality.
The integration between Watson Developer Cloud (WDC) and Watson Explorer follows relatively straightforward web services patterns. All of the WDC services use a basic REST API. This makes it easy to use WDC services from a applications deployed to WDC. In some cases you will find it easier to create an application in WDC that performs some operations. Other times you may find it easier to communicate directly with a cloud based service.
- Watson Explorer Engine can communicate with WDC applications via a parser node (parser nodes in Engine allow for advanced and basic web requests to be made).
- Watson Explorer Application Builder widgets communicate with WDC applications by going through a web proxy deployed to the same web server as Application Builder.
- In WEX 11+, this capability is provided by Application Builder Endpoints.
- In WEX < 11, there is a sample web proxy that can be used to serve some of these needs.
There are five basic integration patterns for combining Watson Explorer and Watson Developer Cloud. The specific integration pattern used will depend on the use cases and desired functionality.
- Application Builder Widget. The most common place to use a cognitive service is from within an Application Builder widget. The Personality Insights sample demonstrates this.
- In the client browser. Once a page is rendered in a user's browser there may be cases in which you would want to allow a user to interact with a WDC application without refreshing the page. For example, a user might dialog with Watson Q&A from an entity page.
- At crawl time. WDC can be crawled from Engine converters thus allowing you to augment the index with additional annotations and metadata.
- At query time. It is also possible to access WDC applications at query time from Engine or Application Builder.
- Pre- or post-process. In some cases it is useful to use a WDC application as a pre- or post-processing step and the output of this is used by the Watson Explorer application in some way.
Setup for IBM Bluemix Development
Watson Developer Cloud provides many different runtimes for your cloud-based applications. To gain access to the Watson Developer Cloud environment you will need to register for an IBM Bluemix account. After registration and configuration of the Cloud Foundry tools, you can setup your development environment.
Steps for Bluemix setup:
- Register for an account on Bluemix
- Install the Cloud Foundry command line tool, installation instructions
Java Web-Based Applications
Here is a simple set-up to get you started with Java runtimes.
Required development tools
- A JDK is required to compile the Java code. Download and install IBM JDK 1.7
- We use Maven to build the sample packages. Download and install Apache Maven
Optional development tools
The following tools and plug-ins can make testing and deployments easier.
- Eclipse Luna Java EE Edition
- IBM Eclipse tools for Bluemix
- IBM WebSphere Application Server Liberty Profile developer tools for Luna
- All required Jars for Java examples will be included via Maven.
Ruby Sinatra Web-Based Applications
Ruby is a scripting language perfect for rapid development and deployment. It is also the language used to configure Application Builder so you will not hvae to learn yet another programming language.
Required development tools
- Ruby is required to compile the code. Follow these instructions for installing Ruby or use the Windows installer if you are running Windows.
- Ruby DevKit is useful for development on Windows. Download and install Ruby DevKit 4.5.2
Keep in mind that by default, WDC supports Cloud Foundry buildpacks for only recent stable releases of Ruby and will eventually deprecate old patch releases.
- Bundler is required to build bundle Ruby Gems and deploy to WDC. Download and install using
gem install bundlerafter setting up Ruby.
Many of the samples assume you've completed some of the out of the box tutorials.
In Watson Explorer, you should:
- Build an Example Metadata collection in Watson Content Explorer, see the Using Metadata for Searching, Sorting, and Filtering tutorial for instructions.
- Learn how to create Application Builder search widgets, see the Creating An Application tutorial for more information.