Use Aha! as a Content Source

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

PREREQUISITES.

You should have view access to the products to be crawled.

PERMISSIONS

SearchUnify respects Aha! permissions in search. It means that the ideas with permissions set to "Not visible" don't appear in the search results. And if an idea is "Visible to creator", then the idea can only be found by the idea creator in search results.

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! API Key, 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.

  3. Click Connect.

Set Up Crawl Frequency

The first crawl is always manual and is performed after configuring the content source. In Choose A Date, select a date to start crawling; the data created after the selected date will be crawled. For now, keep the frequency to its default value Never and click Set and move to the next section.

Select Idea Fields and Projects for Indexing

SearchUnify can index the sole Aha! content type, idea. You can select idea fields for indexing in By Content Type. For instance, you can crawl and index only titles and authors. By Projects allows you to index the ideas linked with selected projects.

  1. Click to select idea fields for indexing.

  2. On moving to By Projects, check projects. In the next image, projects "Fredwin Cycling Product (Demo)" and" Fredwin Software (Demo)" have been selected. The ideas linked to both projects will be indexed. Then, click Save.

NOTE.

Click Reindex to view newly-added projects.

After the 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.

Data Deletion and SU Index

Ideas removed from your Aha! instance don't disappear from the SearchUnify index and may still show up in the search results. A technical limitation restricts SearchUnify from capturing deletion APIs. You can overcome limitation with a webhook. A webhook sends deletion events to SearchUnify in real time and keeps the index up-to-date. To set up a webhook, go to Create an Aha! Webhook for Event Subscription.