Return-Path: X-Original-To: apmail-manifoldcf-commits-archive@www.apache.org Delivered-To: apmail-manifoldcf-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 110DA10717 for ; Fri, 31 May 2013 11:34:14 +0000 (UTC) Received: (qmail 96957 invoked by uid 500); 31 May 2013 11:34:13 -0000 Delivered-To: apmail-manifoldcf-commits-archive@manifoldcf.apache.org Received: (qmail 96882 invoked by uid 500); 31 May 2013 11:34:13 -0000 Mailing-List: contact commits-help@manifoldcf.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@manifoldcf.apache.org Delivered-To: mailing list commits@manifoldcf.apache.org Received: (qmail 96865 invoked by uid 99); 31 May 2013 11:34:12 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 31 May 2013 11:34:12 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 31 May 2013 11:34:10 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 119752388906; Fri, 31 May 2013 11:33:51 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1488173 - in /manifoldcf/branches/CONNECTORS-694/site/src/documentation: content/xdocs/en_US/ resources/images/en_US/ Date: Fri, 31 May 2013 11:33:50 -0000 To: commits@manifoldcf.apache.org From: kwright@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20130531113351.119752388906@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: kwright Date: Fri May 31 11:33:50 2013 New Revision: 1488173 URL: http://svn.apache.org/r1488173 Log: Add CONNECTORS-695 documentation patch. Added: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-configuration-save.PNG (with props) manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-configuration.PNG (with props) manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-job-googledrive-seed-query.PNG (with props) manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-1.PNG (with props) manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-2.PNG (with props) manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-3.PNG (with props) manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-4.PNG (with props) manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-5.PNG (with props) Modified: manifoldcf/branches/CONNECTORS-694/site/src/documentation/content/xdocs/en_US/end-user-documentation.xml Modified: manifoldcf/branches/CONNECTORS-694/site/src/documentation/content/xdocs/en_US/end-user-documentation.xml URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-694/site/src/documentation/content/xdocs/en_US/end-user-documentation.xml?rev=1488173&r1=1488172&r2=1488173&view=diff ============================================================================== --- manifoldcf/branches/CONNECTORS-694/site/src/documentation/content/xdocs/en_US/end-user-documentation.xml (original) +++ manifoldcf/branches/CONNECTORS-694/site/src/documentation/content/xdocs/en_US/end-user-documentation.xml Fri May 31 11:33:50 2013 @@ -1675,8 +1675,64 @@


- -
+ +
+ Google Drive Repository Connection +

The Google Drive Repository Connection type allows you to index content from Google Drives.

+

Each Google Drive Connection manages access to a single drive repository. This means that if you have multiple Google Drives (i.e. different users), + you need to create a specific connection for each drive repository and provide the associated authentication information.

+
+

A Google Drive connection has the following configuration parameters on the repository connection editing screen:

+

+
+

+

As we can see there are 3 pieces of information which are needed to create a succesful connection. The Client ID and Client Secret given by Google Drive + when you register your application for a development license. This is typically done through the Google APIs Console.

+

+
+

+

Once having created a project, we must enable the Google Drive API

+

+
+

+

Then going to the API Access link on the righthand side, we need to select create an OAutg 2.0 client ID:

+

+
+

+ +

After filling in the necessary information, we need to select what type of application we'd like. For our purposes we need to select installed application

+

+
+

+ +

Afterwards we're presented with our Client ID and Client secrets needed for the connector(where the red boxes are):

+

+
+

+ +

Now each user must confirm their acceptance of allowing your application to access their google drive. This is done through a run-of-the-mill OAUTH + approach, but needs to be done before hand. Once the steps are completed, a long-life refresh token is presented, which is then used by the connector. For completeness, we present the needed steps below since they require some manual work.

+

+

    +
  1. Browse to here: https://accounts.google.com/o/oauth2/auth?scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fdrive.readonly&state=%2Fprofile&redirect_uri=https%3A%2F%2Flocalhost&response_type=code&client_id=CLIENT_ID&approval_prompt=force&access_type=offline +
  2. This returns a link (after acceptance) https://localhost/?state=/profile&code=CODE +
  3. Perform a POST: https://accounts.google.com/o/oauth2/token with the following as the body: grant_type=authorization_code&redirect_uri=https%3A%2F%2Flocalhost&client_secret=CLIENT_SECRET&client_id=CLIENT_ID&code=CODE +
  4. The response is then a json response which contains the refresh_token. +
+

+

+

After you click the "Save" button, you will see a connection summary screen, which might look something like this:

+

+
+

+

When you configure a job to use the Google Drive repository connection an additional tab is presented. This is the "Google Drive Seed Query" tab:

+

+
+

+

This tab allows you to specify the query which will be used to seed documents for the indexing process. The query language is specified on the Drive Search Paramters site. Directories which meet the seed query are fully crawled as the query on applies to seeds. The default query indexes the entire drive. Lastly, native Google documents such as spreadsheets and word documents are exported to PDF and then ingested.

+
+ +
OpenText LiveLink Repository Connection

The LiveLink connection type allows you to index content from LiveLink repositories. LiveLink has a rich variety of different document types and metadata, which include basic documents, as well as compound documents, folders, workspaces, and projects. A LiveLink connection is able to discover documents Added: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-configuration-save.PNG URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-configuration-save.PNG?rev=1488173&view=auto ============================================================================== Binary file - no diff available. Propchange: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-configuration-save.PNG ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-configuration.PNG URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-configuration.PNG?rev=1488173&view=auto ============================================================================== Binary file - no diff available. Propchange: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-configuration.PNG ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-job-googledrive-seed-query.PNG URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-job-googledrive-seed-query.PNG?rev=1488173&view=auto ============================================================================== Binary file - no diff available. Propchange: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-connection-job-googledrive-seed-query.PNG ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-1.PNG URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-1.PNG?rev=1488173&view=auto ============================================================================== Binary file - no diff available. Propchange: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-1.PNG ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-2.PNG URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-2.PNG?rev=1488173&view=auto ============================================================================== Binary file - no diff available. Propchange: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-2.PNG ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-3.PNG URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-3.PNG?rev=1488173&view=auto ============================================================================== Binary file - no diff available. Propchange: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-3.PNG ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-4.PNG URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-4.PNG?rev=1488173&view=auto ============================================================================== Binary file - no diff available. Propchange: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-4.PNG ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-5.PNG URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-5.PNG?rev=1488173&view=auto ============================================================================== Binary file - no diff available. Propchange: manifoldcf/branches/CONNECTORS-694/site/src/documentation/resources/images/en_US/googledrive-repository-setup-5.PNG ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream