This article shows how to set up a DocumentsCorePack Service to enable document generation and processing capabilities within your Dynamics 365 or Power App.
Step-by-Step video:
Step-by-Step description:
Step 1: Login or register on www.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
- 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!
After your login select “My Account” and “my cloud services”.
Figure 1: Open the DCP Online Service Configuration
Now this “Service Configuration”-window is shown. Decide which service you want to add (In this case it is for the DocumentsCorePack ServerBased) and then press [+]-button to add a service.
Figure 2: Online Service Configuration
Step 2: Now set up your Dynamics 365 connection.
Here is an overview about the DocumentsCorePack Service Settings.
- Connection Profile: Set up your CRM connection.
- Service Name: This must be a unique service name and cannot be changed.
- DocumentsCorePack Instance: Please select the instance on which the service should be installed. The instance with the best bandwidth is automatically preselected, but you can change it until you have saved the new service.
- Job Type: Specify here which jobs should be processed by the service.
- Use CRM integrated SharePoint: Enable this setting when the documents should be stored in the CRM integrated SharePoint. Otherwise, the documents will be stored as note attachments.
- Show Advanced Options: See this topic later in this article.
Figure 3: Set up your CRM connection
Back to set up your CRM connection. ❶ Press [Connection Profile]-button and choose your connection profile type.
Please note: You should always use “Server2Server” unless asked by our support team to change the type.
❷ Don´t forget to complete your CRM URL and now
❸Press the [Retrieve Organizations]-button. You have to enter your Admin-credentials again. At this point you will be asked for application permissions. Click here for details.
Please note: it is recommended to change the sign-in frequency for your service user as described here.
Figure 4: Set up DCP service
Your organization is shown. Press the [Verify Connection & Save Profile]-button.
Figure 5: Create CRM connection profile
While your connection gets verified, this window is displayed to remind you not to close this window or navigate away.
Figure 6: Verify connectivity and permissions-window
After your connection is set up the setting “Service Name” is required. Select a unique service name and know, that it cannot be changed. Press the [Save Service]-button.
Figure 7: Save Service
This windows gives you some important information about the setup. Please obey the recommendations and press the [OK]-button.
Figure 8: DCP Service Setup and Saving service
Your Service Configuration is Completed when you see this message. Press the [Ok]-button.
Figure 9: Service Configuration Completed
Congratulations! Your DocumentsCorePack Service is running!
Figure 10: Running Service
Addendum:
6. Show Advanced Options (Figure3):
Figure 11: Show Advanced Options and Show even more Advanced Options
- Push Request Logic: Specifiy which Push Request Logic should be used by the DCP Dialog.
- Enable Debugging: In case of any issues during the document generation, we would recommend you to enable debugging here. The log files will be available as soon as the service is saved.
- Notify on service changes: Select this option in order to receive an e-mail every time there is a service change.
- SharePoint Single Location: Specify a SharePoint location for document edits even when no SharePoint integration is enabled within the CRM.
- Force this service to be the only document-generating service: If you select this option, this will be the only service which processes your documents.
- Category: Number category for priorization. Rewuired when using multiple services. Default is 0.
- Server Version: This field informs you about your current DocumentsCorePackversion on your instance.
6a. Show even more Advanced Options
- Only count users with security roles for licensing: This feature was enabled in order to deal with a common issue that all users with an assigned Dynamics 365 will automatically become enabled users in every Dynamics 365 tenant and thus counts towards our license although the users have no access to the tenant. Once enabled, our licensing will count users only if they have at least one security role assigned which is not the case for auto-assigned users from the Office 365 portal.
- 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 a service. If a particular 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.
- Synchronous solution import: If you select this option, the setup will try to import the solutions synchronously.
- Use SharePoint compatibility connection: If you select this option, a compatibility SharePoint connection will be used.
That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com.