IBM App Connect passes key data between IBM Cloudant databases and other apps – automatically, in real time.

You can use App Connect to connect IBM Cloudant databases to your apps by mapping data graphically – without the need for coding – meaning that you can achieve a return on your investment in minutes or hours, not days or months.

If you can’t find what you want, or have comments about the “how to” information, please either add comments to the bottom of this page or .

IBM Cloudant, a highly scalable and performant JSON (JavaScript Object Notation) database service, stores JSON formatted documents. Thanks to functionality offered in App Connect, you do not have to write this JSON by hand, but you are able to define the document properties (names and data types) and then map to those properties as you would any other properties in App Connect.

What should I consider first?

  • To connect Cloudant with App Connect, click Connect either on the Applications tab on the Catalog page, or when you add Cloudant to your flow, and specify the user name and password for your Cloudant service.

    You can find your user name and password for Cloudant on the Service credentials page of your Cloudant service in IBM Cloud (Bluemix).

    These instructions assume that you have already provisioned a Cloudant NoSQL DB service on IBM Cloud.

    1. Log in to IBM Cloud.
    2. In your IBM Cloud Dashboard, click the Cloudant service that you want to work with.
    3. Open the Service credentials page, then click View credentials. (If you want to define new credentials to use, click New credential.)
    4. Copy the user name and password and paste them in to App Connect when you connect to IBM Cloudant.
    The Service credentials page for IBM Cloudant. (Click image to view full size.)
  • You can specify your Cloudant document data structure as data properties (with name and data type) or as a JSON object that consists of comma-separated name/value pairs. For example:
    • Cloudant document data structure specified as data properties:

      (Click the image to view full size.)

      To specify your Cloudant document data structure as data properties, click Add property under the “Document data” heading. (If you have been specifying document data as JSON, ensure that the “Document data” field is empty and then click Add property.) For more information about specifying data properties, see Defining your own data properties.

    • Cloudant document data structure specified as JSON:

      (Click the image to view full size.)

      To specify your Cloudant document data structure as JSON, ensure that there are no properties under the “Document data” heading and then click “Edit mappings”.


    Creating an event-driven flow that syncs updates to Salesforce data with IBM Cloudant documents

    Learn how to use App Connect Designer to create an event-driven flow that when a new Salesforce contact is created, creates a document in IBM Cloudant with data from Salesforce. This tutorial demonstrates how to easily specify your own data properties for an IBM Cloudant document, without needing to write JSON.

    Join The Discussion

    Your email address will not be published. Required fields are marked *