Configuring and Indexing a Basecamp Source
To configure and index a Basecamp source
-
On the Coveo server, access the Administration Tool (see Opening the Administration Tool).
-
Select Index > Sources and Collections.
-
In the Collections section:
-
Select an existing collection in which you want to add the new source.
OR
-
Click Add to create a new collection (see Adding a Collection).
-
-
In the Sources section, click Add.
The Add Source page that appears is organized in three sections.
-
In the General Settings section of the Add Source page:
-
Enter the appropriate value for the following required parameters:
-
Name
-
Enter a descriptive name of your choice for the connector source.
Example: Basecamp
-
Source Type
-
Select the connector used by this source. In this case, select Basecamp.
Note: If you do not see Basecamp, your environment does not meet the requirements (see Basecamp Connector Requirements).
-
Addresses
-
This parameter does not apply to this source, but cannot be left empty.
Example: https://www.basecamp.com
-
Fields
-
Select the field set that you created earlier (see Basecamp Connector Deployment Overview).
-
Refresh Schedule
-
Time interval at which the index is automatically refreshed to keep the index content up-to-date. By default, the Every day option instructs CES to refresh the source everyday at 12 AM.
-
-
Review the value for the following parameters that often do not need to be modified:
-
Rating
-
Change this value only when you want to globally change the rating associated with all items in this source relative to the rating to other sources (see Understanding Search Results Ranking).
Example: When a source replaces a legacy system, you may want to set this parameter to High, so that in the search interface, results from this source appear earlier in the list compared to those from legacy system sources.
-
Document Types
-
If you defined a custom document type set for this source, select it (see What Are Document Type Sets?).
-
Active Languages
-
If you defined custom active language sets, ensure to select the most appropriate for this source (see Adding and Configuring a Language Set).
-
-
-
In the Specific Connector Parameters & Options section of the Add Source page:
-
Using the following parameters, authorize the Coveo crawler to access the content of your Basecamp account:
Account ID
Enter your Basecamp account ID.
Note: After you login to Basecamp, the account ID can be found in the browser address bar after https://basecamp.com/.
Example: https://basecamp.com/3027985/
(For OAuth 2.0 only) Enter the client identifier to use that you previously obtained (see Authorizing the Coveo Connector to Access Your Basecamp Content).
Client Secret
(For OAuth 2.0 only) Enter the client secret to use that you previously obtained (see Authorizing the Coveo Connector to Access Your Basecamp Content).
(For OAuth 2.0 only) Enter the refresh token to use that you previously obtained (see Authorizing the Coveo Connector to Access Your Basecamp Content).
-
In the Mapping File box, the path to the default mapping file that defines how the connector handles metadata often does not need to be changed.
-
The following options must be selected for more content in Basecamp to be indexed.
-
Index Project Drafts
-
Whether the project drafts should be indexed. By default, archived projects are indexed.
-
Index Archived Projects
-
Whether the archived projects should be indexed. By default, archived projects are indexed.
-
-
(Optional) Click Add Parameter when you want to show and change the value of advanced source parameters (see Modifying Hidden Basecamp Source Parameters).
-
The Option check boxes generally do not need to be changed:
-
Index Subfolders
-
This parameter is not taken into account for this connector.
-
Index the document's metadata
-
When selected, CES indexes all the document metadata, even metadata that are not associated with a field. The orphan metadata are added to the body of the document so that they can be searched using free text queries.
When cleared (default), only the values of system and custom fields that have the Free Text Queries attribute selected will be searchable without using a field query (see Adding a Field to Search On and What Are Field Queries and Free Text Queries?).
Example: A document has two metadata:
-
LastEditedBy containing the value Hector Smith
-
Department containing the value RH
In CES, the custom field CorpDepartment is bound to the metadata Department and its Free Text Queries attribute is selected.
When the Index the document's metadata option is cleared, searching for RH returns the document because a field is indexing this value. Searching for hector does not return the document because no field is indexing this value.
When the Index the document's metadata option is selected, searching for hector also returns the document because CES indexed orphan metadata.
-
-
Document's addresses are case-sensitive
-
Leave the check box cleared. This parameter needs to be checked only in rare cases for systems in which distinct documents may have the same name but different casing.
-
Generate a cached HTML version of indexed documents
-
When you select this check box (recommended), at indexing time, CES creates HTML versions of indexed documents. In the search interfaces, users can then more rapidly review the content by clicking the Quick View link rather than opening the original document with the original application. Consider clearing this check box only when you do not want to use Quick View links or to save resources when building the source.
-
Open results with cached version
-
Leave this check box cleared (recommended) so that in the search interfaces, the main search result link opens the original document with the original application. Consider selecting this check box only when you do not want users to be able to open the original document but only see the HTML version of the document as a Quick View. In this case, you must also select Generate a cached HTML version of indexed documents.
-
-
-
In the Security section of the Add Source page:
Important: The connector does not yet support Basecamp permissions. It is thus strongly recommenced to only index Basecamp account with public content.
Note: A workaround is to manually define permissions on the source (see Permissions).
-
In the Authentication drop-down list, depending on your setup:
-
When you grant the connector access to your Basecamp content using OAuth, select (none).
-
When you want to grant the connector access to your Basecamp content using Basic authentication, select the user identity you previously created (see Basecamp Connector Deployment Overview).
-
-
-
Click Save to save the source configuration.
-
When your Basecamp content is all public:
Important: The connector does not yet support Basecamp permissions. This means that, in the Coveo search interface, a user searching Basecamp content could see content to which he has normally no access in Basecamp.
-
In the navigation panel on the left, click Permissions.
-
In the Permissions page, select Specify the security permissions to index.
-
In the Allowed Users and Denied Users boxes, enter the users and groups that you respectively want to allow or deny to see search results from this source. The default is to allow everyone \S-1-1-0\ (Active Directory Group).
-
Click Apply Changes.
-
-
When you are ready to start indexing the Basecamp source, click Rebuild.
-
Validate that the source building process is executed without errors:
-
In the navigation panel on the left, click Status, and then validate that the indexing proceeds without errors.
OR
-
Open the CES Console to monitor the source building activities (see Using the CES Console).
-
What's Next?
Set an incremental refresh schedule for your source (see Scheduling a Source Incremental Refresh).
Consider modifying some hidden source parameters to try resolving other issues (see Modifying Hidden Basecamp Source Parameters).