Skip to content

dgcloud/alfresco-community-docusign

 
 

Repository files navigation

Alfresco Docusign Addon

The Docusign Addon allows a user to request an electronic signature for a document from within Alfresco Share or Alfresco Content App. A signature request can be sent to Multiple Signers and the signature lifecycle may be tracked directly from Alfresco. On completion of the signature request by all signees a completed copy of the signed document is stored in Alfresco for your records.

Building Alfresco Docusign Addon

Clone Alfresco Docusign from github repo
   $ git clone https://github.com/boneill/alfresco-community-docusign.git

Build Alfresco AMPs
   From alfresco-community-docusign directory, run the following command 
 		./run.sh build_start
   The above command generates two amps located in the following directory;
   	Repo AMP
    	alfresco-community-docusign/seedim-docusign-platform/target/seedim-docusign-platform-1.0-SNAPSHOT.amp
	Share AMP 
 	alfresco-community-docusign/seedim-docusign-share/target/seedim-docusign-share-1.0-SNAPSHOT.amp

Build Alfresco Docusign Content App
   From alfresco-community-docusign/alfresco-content-app folder run the following commands to build the Alfresco Docusign Content App.
   Install Alfresco Content App dependencies
	   npm install
   Build ACA-Shared library since the Alfresco Docusign Addon uses resources from the ACA-Shared
	   ng build aca-shared
   Build Docusign library which is the core of the Alfresco Docusign Content App
	   npm run build:docusign
   Run the following command to verify the app builds and works accordingly
	   npm start
   The following command creates a transpiled version of the code in alfresco-community-docusign/alfresco-content-app/dist folder that can be released to a web server like
   Apache/NGIX or a web container like Apache Tomcat. The default release folder is called app but it can be renamed as required e.g workspace.
	   ng build –prod

Installing Alfresco Docusign Addon

Installing Alfresco AMPs
This requires the installation of the Repository and Share amps.
	Download the required AMPs from the release section of the alfresco-community-docusign in Github or download the source code and build the amps as described 
above in the 'Building Alfresco Docusign Addon' section.
	Stop Alfresco
	Copy seedim-docusign-platform-1.0-SNAPSHOT.amp to $AlfrescoHome/amps
	Copy seedim-docusign-share-1.0-SNAPSHOT.ampto $AlfrescoHome/amps_share
	Run <AlfrescoHome>/bin/apply_amps.sh -force for Linux and <AlfrescoHome>/bin/apply_amps.bat -force for Windows
	Start Alfresco
	Important:  
	On startup of the new install a bootstrap class creates the necessary config files in the Data Dictionary.  
	A bootrap class will only run once and cause the startup to fail on subsequent starts.  
	In order to prevent this, you must disable the bootstrap as follows: 
  		Locate your alfresco-global.properties file.  Depending on the installation it is often located in $AlfrescoHome/tomcat/shared/classes 
  		or $AlfrescoHome/tomcat/webapps/alfresco/WEB-INF/lib.
  		Add the following config in the global alfresco-global.properties:  DS_MODULE_BOOTSTRAP_DATA=false

Installing the Alfresco Docusign Angular Application (Alfresco Content App)

The following install instructions are for installing the Angular Application on the Tomcat that you are running Alfresco on. However, it does not need to be co-located with the Alfresco application and could be installed on nginx or apache web server.

  Download the alfresco-docusign.zip from the release section of the alfresco-community-docusign project in Github or download the source code and 
  build the angular distribution files as described above in the 'Building Alfresco Docusign Addon' section.
  Extract the alfresco-docusign.zip folder and copy the alfresco-docusign folder to Tomcat webapps directory.
  Update the app.config.json (in the root of the alfresco-docusign folder). Set “ecmHost”: “<URL to your Alfresco application>.eg http://localhost:8080”

Configuring Alfresco Docusign Addon

Once Alfresco has started, browse to Repository > Data Dictionary.

docusign_config_folder

You should see a folder called Docusign-Config. Hover over it and click on Edit Properties > All Properties. The following form should be available.

docusign_config_form

Fill in the JWT Authentication details for your Docusign Account
Docusign Client Id (API ID): <YOUR Docusign API ID>
Docusign User Id: <YOUR Docusign USER ID>
Target Account:FALSE
Docusign Auth Server URL: account.docusign.com
Docusign Private Key
  		Open your Docusign Private API with your favourite text editor, copy and paste its content in the Docusign Private Key box.
	Note
	Docusign Auth Server URL can be set to account-d.docusign.com for testing purposes.

Using Alfresco Docusign Add On Please see below link for using the Alfresco Docusign Add On from Alfresco Share or Alfresco Content App https://www.seedim.com.au/alfresco-addon-documentation/#getting-started

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 85.7%
  • Java 6.6%
  • HTML 3.4%
  • JavaScript 2.0%
  • SCSS 1.0%
  • Shell 0.7%
  • Other 0.6%