We have all been there. Working with Microsoft Dynamics 365 (CRM) is really great, but sometimes, the data storage costs go through the roof. And yes, saving data in Microsoft Dynamics 365 can be cost-intensive. Consequently, we solved this problem by creating AttachmentExtractor.

This blog article outlines how easy it is to setup the AttachmentExtractor Online Service Configuration. Additionally please also find our video tutorial for AttachmentExtractor that shows how to start the AE Online Configuration, here. 

The main advantages of the AttachmentExtractor Online Service are:
- There is no need for a local server anymore.
- All AttachmentExtractor features are available
- The configuration is easy
- The service is hosted and updated by our support team

Please follow the below step-by-step tutorial in order to start an AttachmentExtractor Online Service properly.

Step 1: Open the Online Configuration Service

One possible way to start a new AttachmentExtractor Online Service Configuration is via our website www.mscrm-addons.com. On our website, please navigate to Products, select AttachmentExtractor and then, click on the Configure Service button.

Figure 1: Open the Online Configuration Service

Next, login or register to mscrm-addons.com.

Figure 2: Login or register to mscrm-addons.com

The registration is quick and free. Once logged in, you will

- have access to all our free 14-days trial versions
- be able to request full support on all trial versions
- be allowed to purchase licenses
- receive our newsletter
- be able to upgrade free trial versions to licensed products

So – if you haven’t registered yet – it’s worth a try!

Step 2: The Online Configuration window

Once you have logged in, you will be provided with the Online Configuration window. 

Please note: If you have already configured a service, you get an overview of your hosted service(s) ❶. 

 If there is no service configured,  you can setup a service with a click on the [Add]-button ❷.

Figure 3: Online Configuration window

Please click on the [Add]-button in order to add a new service. Next, click on the [Connection Profile]-button. 

Figure 4: Create a new AE Service

- your Microsoft Dynamics 365 type  ❶: Server2Server, Office 365, Live ID or IFD (hosted) and 

- type in your CRM URL ❷ and your 

- user credentials ❸ (in that case your username and your password). 

To finish the process, click on the [Retrieve Organizations]-button ❹. ​

Figure 5: Create a CRM Connection Profile

As soon as your organization appears in the Available Organizations section ❶, click on the [Verify Connection & Save Profile]-button ❷.

Figure 6: Verify your connection and save your profile

Now the following window appears. It is important that you do not close this window or navigate away. 

Figure 7: Verify connectivity and permissions

You are now back on the same window as before. This window supports you creating a new service.

Figure 8: Create new AttachmentExtractor Online Service

❶ Service Name
Please enter your service name here. But choose wise, because the name cannot be changed anymore!          

AttachmentExtractor Instance
Please select on which instance the AttachmentExtractor Service should run. The instance with the highest bandwidth is automatically selected for you. 

❷ SharePoint Integration
Please choose, if you would like to use the CRM integrated SharePoint or a specific SharePoint. If you want to use a specific SharePoint, you must enter a SharePoint path, which means you must enter a SharePoint URL that includes the library.

Storage Option for Entities without Document Management enabled
Entities without document management may be stored daily or weekly on a specific SP library. Else, you may decide which entities not to extract. 

SharePoint Credentials
Please insert the credentials of a SharePoint user with administrative access to your configured SharePoint here.

❸ Extract
Using the drop-down menu of this option, allows you to decide what you would like to extract with AttachmentExtractor. Please select all options or only some of these options. The available options are:
           - Email Attachments
            - Note Attachments
            - Email Body
            - Note Body 

Please note: This section also allows you to configure an email or note subfolder, where your extracted emails or notes will be saved. 

❹ Data processing
Please specify if you only want to copy your attachments to SharePoint or if you want to extract them completely. Once extracted files will be replaced with a .url file which points to the extracted file on SharePoint. However, if you click on the [Extract – Replace data in CRM]-button, you will receive a warning. Please read it carefully, check the corresponding checkbox and select whether you want to copy or extract the files by clicking on the corresponding button. 

Figure 9: AttachmentExtractor Service Setup Warning

❺ Minimum Attachment Size Filter
Please insert the minimum size a file should have in order to be extracted by your AttachmentExtractor Service here.

❻ Only extract attachments older than
If you only want to extract attachments older than a certain amount of time, you can specify this here.

❼ Show Advanced Options
A click on this button expands some options for the advanced configuration.

Please note: If you feel that the configuration so far satisfies your needs, you can save your service now with a click on the [Save Service]-button in the right lower corner and proceed with Step 6. But of course, the service can as well be configured on an advanced level, which can be done in the Advanced Configuration-section. This optional part of the configuration will be explained below.

Step 4: Set the Advanced Options (optional)

With a click on the [Show Advanced Options]-button, the settings of your new service can be refined.

Figure 10: Advanced Configuration Options

❶ Enable debugging
In case of any issues during the extraction, we would recommend you to enable debugging by selecting this option. The log files will be available for download as soon as the service is saved. 

❷ Stop service on critical errors
If you select this option, the service will automatically stop if a critical error occurs. This option is activated by default. 

❸ Create SharePoint attributes
Enabling this option will create SharePoint attributes for transferred files.

❹ New folder per
Please select if new folders should be created on a weekly or a daily basis here. This option only applies to CRM Integrated SharePoint. 

❺ Blacklist or Whitelist
Please decide whether you would like to use a black- or a whitelist here. Entities on the blacklist will NOT be extracted, while entities on the whitelist will be extracted.

❻ Notify on service changes 
Select this option in order to get an eMail every time there is a service change.           

❼ Skip solution import
If you select this option, the setup will assume that you have already imported all solutions that are necessary for the creation of an AttachmentExtractor service. If any solution is missing, the creation of the new service will fail.

❽ Skip role assignment
If you select this option, you will either have to create a custom role covering the required rights or you will have to manually assign the security roles. 

❾ Server Version
This field informs you about the current AttachmentExtractor version on your instance. 

Step 5: Save your service
No matter how detailed you have configured your service, please click on the [Save Service]-button in the right lower corner in order to proceed. 

Click on the [OK]-button in the window that appears now.

Figure 11: AttachmentExtractor Service Setup

Please note: Do not close the following window or navigate away as long as the serivce is saved. Instead, have a break and enjoy some coffee or tea.

Figure 12: Saving the service

Step 6: Service Configuration Completed

As soon as the service configuration is completed, you will be informed about the next steps you can take. Click on the License Status-option in order to check your license status. Please read the instructions carefully and click on the [OK]-button in order to proceed.

Figure 13: Service Configuration Completed

Step 7: Start your service

Congratulation! You have finished the configuration of your service. You are now redirected to the service configuration overview. Using the buttons at the end of the service overview, you can define which steps you would like to take next. Please find a brief description of the buttons below.

Figure 14: Configuration buttons

❶ The [Add service]-button
Simply click on the [Add]-button (+) in order to create a new AttachmentExtractor Service. 

Please click on the [Configure Service]-button (monkey wrench) in order to modify the DocumentsCorePack Service settings. A double click on the service you would like to modify has the same effect. 

❷ The [View & Install License]-button
Click this button in order to check your license state or to install a new license.

❸ The [View Service Logs]-button
A click on this button will provide you with an overview of the latest event log entries for your service. Double-click a certain row in order to see details. 

❹ The [View Version Info]-button
Click this button in order to receive information on your CRM version and the AttachmentExtractor version.

❺ The [Play Service]-button
Click on this button in order to start your service. 

❻ The [Stop Service]-button
Click on this button in order to stop your service.

❼ The [View Progress & history]-button
A click on this button will provide you with an overview of the extraction progress and failed extractions.

❽ The [Reset extraction]-button
Click on this button in order to reset all previous extractions.

❾The [Move Service]-button and 
A click on this button enables yout to move the service to another instance.       

❿The [Delete Service]-button  
With a click on the Garbage bin, you have the possibility to delete a services.

Please note, that this step will delete the service configuration and the AttachmentExtractor Service, but it will NOT delete the CRM solutions referring to AttachmentExtractor. These solutions must be deleted manually.



That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com.

Figure 1: Add Multiple Views button

This example will result in a button that only counts and shows your Closed Activities.

Figure 2: The Activities Closed button 

​

The minute your DocumentsCorePack (DCP) license is invalid, it is recommended to check your license status and to react properly. This article outlines

• how to view the license state of your service and
• how to upgrade your license online.

A) How to view the license state of your DCP Online Service?

1) Follow the below link and enter your username and password.
http://www.mscrm-addons.com/language/en-US/LoginPage?returnurl=/language/en-US/Products/MS-CRM-2013/DocumentsCorePack/Cloud-Service-Configuration

Figure 1: Login to mscrm-addons.com

2) Once registered, click on the [My Account]-button in the right upper corner.  

 ​Figure 2: Open your account 

3) Now click on the my cloud services-section in order to get an overview on your subscriptions.

Figure 3: My Cloud Services 

4) You are redirected to the DocumentsCorePack Online Configuration. Please mark your service and click on the [View and Install License]-button.

Figure 4: DCP Online Configuration

5) The license information window appears. A red cross always signalizes that a license is invalid. There are numerous reasons for an invalid license.
In this example, the reason why is that the user owns less site licenses than he actually needs. To overcome this issue, the user has to upgrade the license.

Figure 5: License information overview 

B) How to upgrade a DCP Online license?

1) Please log in to your account on our website and open the Account Overview. Next, click on the [Modify package size]-button.

Figure 1: Modify your package 

2) Now you are redirected to the UpgradeSubscription-section. Please click on the [Upgrade]-button in the right lower corner. 

Figure 2: Upgrade your license

That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com!

This article outlines where to find the version number for each mscrm-addons product. If you use Microsoft Dynamics CRM 2015 or 2016 please have a look at this article.

Click the below link for the addon that you wish to find the version number for:

• ActivityTools
• AttachmentExtractor
• DocumentsCorePack ServerBased
• DocumentsCorePack Client
• GroupCalendar
• PowerSearch
• SmartBar
• TelephoneIntegration Server
• TelephoneIntegration Client

ActivityTools, DocumentsCorePack ServerBased (DCP SB), PowerSearch and SmartBar

For these four solutions, there is a simple way to find the current version number:  Open your Microsoft Dynamics 365 and navigate to Settings.  When you go to Products, you´ll see these four solutions. Select the one you want and you will be provided with the Getting Started window, which contains the version number (see figure 1 - highlighted in yellow). The below example shows the ActivityTools version number, but this way also applies to DocumentsCorePack ServerBased, PowerSearch and SmartBar. 

Figure 1: mscrm-addons version number for MS Dyn 365

AttachmentExtractor

If you use the Online version, you don´t need to provide the version number because our support is well aware of it. 

For the OnPremise version just follow the next steps.  ​Please look for AttachmentExtractor Installation in the StartPanel. 

Now the following window appears. It shows the AttachmentExtractor version number (highlighted in yellow) for Microsoft Dynamics 365.

DocumentsCorePack Client (DCP Client)

To verify the current DocumentsCorePack Client version number, start MS Word, navigate to the www.mscrm-addon.com-tab and click on the [DocumentsCorePack Settings]-button.

In the settings window select the About-tab, where the version number is displayed (see highlighted in yellow). 

Figure 5: DCP Client version number 

GroupCalendar

To verify the current GroupCalendar (GC) version number for Microsoft Dynamics 365, open GroupCalendar and click on Settings on the right side (see highlighted below in yellow). The version number is displayed in the window that opens now in the right upper corner (also highlighted in yellow).  

Figure 6: GroupCalendar version number;

TelephoneIntegration Server

To verify the current TelephoneIntegration Server (TI Server) version number, start Configuration – TelephoneIntegration Server for MS Dyn 365 from the StartPanel. 

Figure 7: Search for the TI Configuration

The following window appears. It shows the TI Server version number (highlighted in yellow) for MS Dyn 365.

Figure 8: TI Server version number

TelephoneIntegration Client

To verify the current TelephoneIntegration Client (TI Client) version number, click on the TelephoneIntegration-icon in the taskbar:

Figure 9: TelephoneIntegration Client icon

Figure 10: TI client version number

That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com.

This blog article outlines how to handle this error message when designing DCP Templates.

Figure 1: DocumentsCorePack error message: Invalid URI: The hostname could not be parsed

Please note: If you get this error message, you´ll have to make sure that the links you are using in your templates are correct and work. If you try to click a link in Word and you get an error, you´ll have to remove the link and create it again. Then the website opens correctly and DCP can generate the documents again without problems.

That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com.

 ​