Use Aha as a Content Source

This article walks you through the steps of using AHA as a content source.

Establish a Connection

1. Navigate to Content Sources.

   

2. Click Add New Content Source.

   

1. Find Aha and click Add.

   

2. In the form, enter: 
   1. Name. A name for your content source. A name is used to distinguish a content source form others in the admin panel. In the image, the sample name is "Aha Product Ideas." 
   2. Client URL. The Aha instance URL.
   3. Language. Select the languages in which the features have been described. English is set by default.
   4. Authentication Type. Select either OAuth or API.
      • OAuth is selected by default. A Client ID and Client Secret are needed for OAuth to work. The procedure to obtain both from Aha! has been described in Get Your Aha! Client ID and Client Secret.
      • API. When API is selected, a new field API Key appears. Enter your Aha API Key in the field. API keys are generated from Aha. The key is used in the same way as an OAuth token in the headers. For example: curl -H "Authorization: Bearer 1111111111" https://company.aha.io/api/v1/features/APP-1. Here, 1111111111 is the API Key.

   

Set Up Crawl Frequency

The first crawl is always manual and is performed after configuring the content source. For now, keep the frequency to its default value Never and click Set and move to the next section.

Select Idea Fields and Products for Indexing

SearchUnify can index the sole Aha content type, Ideas. You can configure which fields or parts of the idea object are indexed in By Content Type. For instance, you can decide to limit crawl and indexing to idea titles and authors. In By Products, check products. Only the ideas associated with checked products are indexed.

1. Click to describe idea fields for indexing.

   

2. On moving to By Products, check the products, listed alphabeticallly. Only the ideas associated with checked products are indexed. Fredwin Software (Demo) has been checked in the next image. The ideas related to Fredwin Software (Demo) are going to be crawled. At the same time, the crawler is going to ignore all the ideas related to Fredwin IT (Demo).

   

3. Click Save.

   

4. On the Content Sources screen, click to index your Aha instance for the first time. The first crawl must be manual but the subsequent crawls proceed according to the time period described in Set Frequency.

NOTE.

Click Reindex after adding new products in your Aha instance. The new products will be listed in By Products.

First Crawl

Return to the Content Sources screen and click in Actions. The number of indexed documents is updated after the crawl is complete. You can view crawl progress in in Actions. Documentation on crawl progress is in View Crawl Logs.

NOTE 1

Review the settings in Rules if there is no progress in Crawl Logs.

NOTE 2

For Mamba '22 and newer instances, search isn't impacted during a crawl. However, in older instances, some documents remain inaccessible while a crawl is going on.

Once the first crawl is complete, click in Actions open the content source for editing, and set a crawl frequency.

1. In Choose a Date, click to fire up a calendar and select a date. Only the data after the selected date is indexed.

   

2. Use the Frequency dropdown to select how often SearchUnify should index the data. For illustration, the frequency has been set to Weekly and Tuesday has been chosen as the crawling day. Whenever the Frequency is other than Never, a third dropdown appears where you can specify the interval. Also, whenever Frequency is set to Hourly, then manual crawls are disabled.

   

3. Click Set to save crawl frequency settings. On clicking Set, you are taken to the Rules tab.