To install Google Docs Integration, you need to apply the Google Docs AMP files to enable the feature.
With Google Docs Integration, you'll see new actions for creating documents, spreadsheets, and presentations. Also, you'll see an action called Edit in Google Docs on all supported document types.
For Alfresco Content Services, browse to the Support Portal [6]:
alfresco-googledocs-repo-3.1.x.amp | This AMP contains the Google Docs functionality that is applied to the core repository. The AMP should be applied to the tomcat/webapps/alfresco directory. |
alfresco-googledocs-share-3.1.x.amp | This AMP file contains the additional Google Docs functionality that is applied to an existing Alfresco Share user interface. The AMP should be applied to the tomcat/webapps/share directory. |
For Alfresco Community Edition, you'll need:
alfresco-googledocs-repo-community-3.1.x.amp | This AMP contains the Google Docs functionality that is applied to the core repository. The AMP should be applied to the tomcat/webapps/alfresco directory. |
alfresco-googledocs-share-community-3.1.x.amp | This AMP file contains the additional Google Docs functionality that is applied to an existing Alfresco Share user interface. The AMP should be applied to the tomcat/webapps/share directory. |
For the repository:
java -jar <installLocation>\bin\alfresco-mmt.jar install <installLocation>\amps\alfresco-googledocs-repo-<version>.amp <installLocation>\tomcat\webapps\alfresco.war
For Alfresco Share:
java -jar <installLocation>\bin\alfresco-mmt.jar install <installLocation>\amps_share\alfresco-googledocs-share-<version>.amp <installLocation>\tomcat\webapps\share.war
Alternatively, if your installation is running in the Tomcat application server, you can use the <installLocation>\bin\apply_amps command to apply all AMP files that are located in both the amps and amps_share directories.
Install both Google Docs AMP files at the same time by using the apply_amps command:
The apply_amps command checks the version of Alfresco Content Services so that you install the relevant AMP package to the correct version.
Enterprise-only releases: For advanced configuration, you can customize how Google accounts are authenticated. See Authenticating Google accounts with Alfresco Content Services [8] for more information.
Google Docs property | Example setting | What is it? |
---|---|---|
googledocs.enabled | true | Enables the Google Docs
functionality. If you set this option to false, the Edit in Google Docs action will not be available. Documents that are currently being edited will still be available using the Resume editing in Google Docs action until they are saved or discarded. |
googledocs.idleThresholdSeconds | 600 | Sets the idle time threshold in seconds. Additional Google users that you invite to collaborate on the document will be considered to be 'idle' after this period. The period is measured from the time when the user last made a change to the document. When saving documents back to Alfresco Content Services, or discarding changes, you must confirm that you want to disconnect any non-idle users before the action completes. |
If you do not want to save the changes, click Cancel.
When this configuration is added to the Google Docs Integration, you can define the OAuth flow by creating your own web application configuration in the Google API Manager.
This file lets users authenticate their Google account with Alfresco Content Services.
Check that you have enabled the Google Drive API.
This allows your registered application to access the Drive API.
This is what the application will be known as in your users Google Account.
This is the path to the google-auth-return.html page.
You may be see a popup showing your Client ID and Secret. If so, click OK.
Next, use the Repository Administration Console to add your custom configuration.
The following table shows the file format restrictions for content that integrates with Google Docs.
File type | Description |
---|---|
DOC | A Microsoft Word 97-2003 document. |
XLS | A Microsoft Excel 97-2003 Workbook. |
PPT | A Microsoft PowerPoint 97-2003 Presentation. |
DOCX | An XML-based Microsoft Word document. |
XLSX | An XML-based Microsoft Excel Workbook. |
PPTX | An XML-based Microsoft PowerPoint presentation. |
Google places further restrictions on the size and complexity of documents that can be edited in Google Docs. The Edit in Google Docs action is not available for documents or spreadsheets larger than 2 MB and presentations larger than 50 MB. Google also prevents editing of other documents that exceed their published limits. See the published Google size limits [13].
Copyright 2020 by Alfresco and others.
Information in this document is subject to change without notice. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Alfresco. The trademarks, service marks, logos, or other intellectual property rights of Alfresco and others used in this documentation ("Trademarks") are the property of Alfresco and their respective owners. The furnishing of this document does not give you license to these patents, trademarks, copyrights, or other intellectual property except as expressly provided in any written agreement from Alfresco.
The United States export control laws and regulations, including the Export Administration Regulations of the U.S. Department of Commerce, and other applicable laws and regulations apply to this documentation which prohibit the export or re-export of content, products, services, and technology to certain countries and persons. You agree to comply with all export laws, regulations, and restrictions of the United States and any foreign agency or authority and assume sole responsibility for any such unauthorized exportation.
You may not use this documentation if you are a competitor of Alfresco, except with Alfresco's prior written consent. In addition, you may not use the documentation for purposes of evaluating its functionality or for any other competitive purposes.
If you need technical support for this product, contact Customer Support by email at support@alfresco.com. If you have comments or suggestions about this documentation, contact us at documentation@alfresco.com.
This copyright applies to the current version of the licensed program.
While Alfresco has used commercially reasonable efforts to ensure the accuracy of this documentation, Alfresco assumes no responsibility for the accuracy, completeness, or usefulness of any information or for damages resulting from the procedures provided. Furthermore, this documentation is supplied "as is" without guarantee or warranty, expressed or implied, including without limitation, any warranty of fitness for a specific purpose.
Links:
[1] https://docs.alfresco.com/../tasks/googledocs-amp-install.html
[2] https://docs.alfresco.com/../concepts/googledocs-configuration.html
[3] https://docs.alfresco.com/../concepts/googledocs-filetypes.html
[4] https://docs.alfresco.com/../reuse/copyright.html
[5] https://docs.alfresco.com/../reuse/disclaimer.html
[6] http://support.alfresco.com
[7] https://docs.alfresco.com/../concepts/googledocs-intro.html
[8] https://docs.alfresco.com/../tasks/googledocs-config-auth.html
[9] https://docs.alfresco.com/../concepts/googledocs-props.html
[10] https://docs.alfresco.com/../tasks/adminconsole-googledocs.html
[11] https://raw.githubusercontent.com/Alfresco/googledrive/master/google-auth-return.html
[12] https://console.developers.google.com
[13] https://support.google.com/drive/answer/37603?hl=en