How to Set Up and Configure the Alfresco Connector

All BA Insight connectors can be downloaded from Right Answers under Knowledge > BA Insight > Product Downloads > Connectors.

This connector is installed with the same generic steps as any BA Insight connector.

Satisfy the Prerequisites for your connector before installing.

Configuration specifics are detailed below.

Post-Installation Actions

After you have successfullly installed the connector, use the following steps to detect and process deleted items during incremental crawls.

How to Remove Deleted Items From Your Search Index

If you wish the Alfresco Connector to pick up deleted index entries during an incremental crawl, you must enable Alfresco auditing. 

  1. Navigate to the directory <Alfresco Content Services install location>/tomcat/shared/classes/alfresco-global.properties.

  2. Set the audit.enabled and audit.alfresco-access.enabled properties to true (by default, these properties are set to false).
  3. Navigate to the directory <BA Insight Alfresco Connector installation directory>/AuditFile and copy the file BAIAudit.xml.

  4. Paste the file BAIAudit.xml into the directory <Alfresco Content Services install location>/tomcat/shared/classes/alfresco/extension/audit.

  5. Restart the Alfresco Content services.

  6. All deleted index entries made from this point onwards are now picked up by the audit.

Connection Configuration Specifics

The following steps add a connection to the Connector Framework.  

  1. Navigate to the Connector Framework. On the “Connections” tab, select “WebService Connection” from the “Add New” dropdown list.

  2. Enter the basic connection data:
    1. Title:
      1. The name used for the connection.
    2. Content Owner:
      1. The Sharepoint user who will have full access to all of the content crawled by this connection.
      2. Typically, this is a service account.
    3. Discovery Group 
      1. Optional
      2. Any AD group that will also be granted access to all items crawled by this connection.
    4. Web Service:
      1. The URL to the connector web service.
      2. The URL is in the format:
        http://<host>:<port number>/dataconnector.asmx
        1. <host> is the FQDN, host name, or IP of the server where the connector is installed
        2. <port number> is the port number entered during the installation wizard process

  3. Click Connect or Refresh Web service. The page re-loads with additional options.

  4. Complete the information to connect to the Alfresco connector.
    1. Alfresco Content Service Login:
      1. Username and password of the Alfresco Content services administrator.
    2. Alfresco API:
      1. URL of the Alfresco Content services.
      2. The default installation location for Alfresco on premise is http://127.0.0.1:8080.

Content Configuration Specifics

To create Alfresco content and generate metadata, use the following steps:

  1. Navigate to Tasks > Mailboxes/Datastore.
  2. Run a DataStore Types Load job.

  3. Create the Alfresco Content.

  4. Filter (optional): If you want to limit crawl to only certain Alfresco sites and not the entire repository, enter the site ids, one on each row.
    1. To obtain a site ID, check the site URL which is typically in the format:
      <protocol>://<domain>:<port>/Site/<id>.
  5. Navigate to Content > Metadata and generate metadata for the newly created Alfresco Content.

Connection Security Specifics

  1. Navigate to Tasks > Security for your Alfresco connection.

  2. Run the Security Sync job.