USER GUIDE
PowerAttachment
USER GUIDE | PowerAttachment
Contents
Overview Configuring PowerAttachment Location Type URL Username Password Document Library SharePoint Type SharePoint Domain Attachment Types Email CycleModify original email with URL link Overwrite existing duplicate file Cloud
PowerAttachment Security Roles Using PowerAttachment
Attachments for Email Activities Sending an Email with Attachments Receiving an Email with Attachments Attachments in Notes sections
USER GUIDE | PowerAttachment
Overview
PowerAttachment is a managed solution that sits in CRM that will push your attachments to your SharePoint site removing the document from CRM and replacing it with a link to the document that is now stored in SharePoint, saving you storage in your CRM system! This guide will walk you through how PowerAttachment works in your CRM system.
Configuring PowerAttachment
Once you have imported and registered the PowerAttachment solution for your Microsoft Dynamics CRM system it will need to be configured to connect to your SharePoint. To configure PowerAttachment navigate to to Settings > Solutions and double click on PowerAttachment, the configuration window is on the set-up tab.
Location Type
Select which service you would like the PowerAttachment solution to push you documents to. By default the setup will push your attachments to SharePoint.
URL
Enter the URL, specific to your database, for the service that you are pushing your documents to.
Username
Enter the username used to access the service that you are pushing your documents to.
Password
USER GUIDE | PowerAttachment
Document Library
Enter the Library name you would like PowerAttachment to file your documents. (I.e. Shared Files) Within this location PowerAttachment will use the file structure of Year > Month > Day, based off of the day the
attachment was pushed to SharePoint
SharePoint Type
In this field choose whether you are using SharePoint Online or Hosted.
SharePoint Domain
Enter the domain of your SharePoint. (I.e. if using a PowerObjects Hosted org you would enter “PowerObjects.”
Attachment Types
Enter all document types you would like to accept through PowerAttachment. Any document types not listed here will be left as attachments in CRM.
Email Cycle
Number of emails to include in each sync cycle (the syncing cycle runs every 5 minutes).
Modify original email with URL link
If you would like PowerAttachment to replace the actual attachment in each email activity with a link to the stored document in SharePoint, select “Yes.” If you would like to keep the attachment intact in each email activity, select “No.”
Overwrite existing duplicate file
In this field you can choose whether you would like the solution to automatically overwrite existing duplicate files in SharePoint or whichever service you chose to push your attachments to or not.
Cloud
In this field you are able to denote which Azure cloud you would like the PowerAttachment solution to use. The last tab you will have to configure is the ‘Excluded Entities’ tab. Under this section you can choose to exclude specific entities in your CRM system from working with PowerAttachment. If an entity is listed in the Exclude Entities section the PowerAttachment solution will not trigger for attachments added to the entity.
PowerAttachment Security Roles
Once PowerAttachment is imported you will notice two new security roles in your CRM system. The first is PowerAttachementAdmin, this security role should be granted to the user whose login information is entered in configuration. The second security role is PowerAttachementUser, this role should be applied to all users that you want to be able to use PowerAttachment.
USER GUIDE | PowerAttachment
Using PowerAttachment
Once you have setup the PowerAttachment configuration, the solution will move all new attachments in the CRM system to your SharePoint site. The PowerAttachment solution will not touch any pre-existing
attachments in your system or document types that are not defined in the “Attachment Types” field in the setup.
Note: PowerAttachment will sync documents to your SharePoint every 5 minutes.
Attachments for Email Activities
If you navigate to an Email Activity in your CRM system, you will notice not much has changed with the form. We have simply added a section towards the bottom of the form for PowerAttachment, this is where your links to the SharePoint documents will appear once they have been synced.
USER GUIDE | PowerAttachment Sending an Email with Attachments
The process of sending an email with an attachment has not changed; simply write out your email content > save > attach your files > send.
USER GUIDE | PowerAttachment
Once the email has sent, PowerAttachment will sync the attachments to SharePoint and place links to the documents in the PowerAttachments section of the form.
Receiving an Email with Attachments
PowerAttachment will also work with emails that are tracked back to CRM using the Outlook CRM client. Again, the solution
USER GUIDE | PowerAttachment
will take the attachments and push them to SharePoint; placing links to the documents in the PowerAttachments section.
Attachments in Notes sections
Additional to the Email Activity, PowerAttachment will move any attachments added to any entity in your CRM system to your SharePoint site. This can be an out of box entity or even custom; if there is a specific entity you do not want PowerAttachment to work with, you can define this is in the “Exclude Entities” section of the setup.
USER GUIDE | PowerAttachment
In the second screen shot we can see the second attachment on the case record has been moved and replaced with a link to the document in SharePoint.
Uninstalling PowerAttachment
To uninstall, navigate to Settings > Solutions > select the PowerAttachment solution and select delete. Deleting the solution from your CRM system will not remove any existing attachments in SharePoint that have been populated by the solution. However, future attachments will not be pushed to SharePoint.
