The Service Configuration page is the central hub for managing your services. Here, you can create brand new services, or configure and modify existing ones.
This article outlines the array of options available on this platform, beginning with how to access the service configuration itself.
Table of Contents
Accessing the Service Configuration
Accessing the Service Configuration
To access the Service Configuration, navigate to our (1) website and click on (2) My Account. You can then access the Service Configuration page by selecting (3) Manage Services.
The Service Configuration page displays a list of configured services. If no services are configured, the page will be left empty.
Selecting any services will bring up the Service Configuration Overview, along with a list of tabs that contain more configuration options and other information.
1. Overview
This page shows all the essential information about the service, like the Status, Dataverse URL, Organization, etc, as seen in the highlighted section of the figure below.
In this section, you can also Stop, Move, Reset Extractions, and Delete the service.
2. Configuration
The Configuration tab is divided as follows:
- Save button: Update your service here.
- Dynamics Details: Find the essential details about Dynamics 365 in this section. You can also edit or open Dynamics 365.
- SharePoint Details: Find an overview of your SharePoint connection here. You can edit or remove the connection.
- Extraction mode: Select if email content or attachments should be extracted.
- Storage system: Decide which attachment storage system your AttachmentExtractor Service should use.
- SharePoint Integration: Select in your SharePoint settings whether you want to use Dynamics 365 Integrated SharePoint or a specific SharePoint location.
- Storage Option for Entities without Document Management enabled: Entities without document management enabled can be stored daily or weekly on a specific SharePoint library. You can also decide which entities not to extract.
- Extract: Select what should be extracted.
- Email Subfolder: Extracted email attachments will be saved to the location defined here.
- Note Subfolder: Extracted note attachments will be saved to the location defined here.
- Appointment Subfolder: Extracted appointments will be saved to the location defined here.
- Data Processing: Specify if only a copy of your attachments should be saved to SharePoint or if you want your attachments extracted entirely. Once extracted, the file is replaced with a .url file that points to the extracted file on SharePoint.
- Minimum attachment size filter: Set the minimum size for attachments to be extracted.
- Only extract attachments older than: Enter a time value to extract attachments that are older than X hours/days/weeks/months. (minimum value = 0).
- Enable text-only E-mails in timeline: Decide if only e-mail text or if all e-mail content should be displayed in the timeline.
Advanced Settings
- Enable Debugging: When enabled, generates debug logs during the extraction process. Log files will be available as soon as the service is saved.
- Stop service on single item error: When enabled, the service will stop if an error occurs with a single item.
- Single Item Error Threshold: The service will stop after a specified number of single item errors.
- Add markup to filenames for extracted files: This option is activated by default. Please note that disabling will remove any visible indicator to an extracted attachment.
- Create SharePoint Attributes: When enabled, this option will create SharePoint attributes for all transferred files.
- New folder per: Specify if a new folder should be created weekly or daily. This option only applies to Dynamics 365 integrated SharePoint.
- Blacklist / Whitelist: Specify if a blacklist or whitelist should be used and select the entities to be added. Entities on the blacklist will not be extracted. Entities on the whitelist will be extracted.
- Notify service changes immediately: To avoid false positives, we send out emails after 30 minutes if there is still an issue with the service. Select this option to receive an email immediately instead.
- Static time range start: Set the start of the time range.
- Static time range end: Set the end of the time range.
- Skip solution import: If this option is enabled, the setup will assume that you have already imported all solutions that are necessary to create a service and skip the import process. Please note that if a particular solution is missing, the creation of the new service will fail.
- Synchronous solution import: When enabled, the setup will try to import the solutions synchronously.
- Skip role assignment: When enabled, role assignment will be skipped. Please note that in doing so, a custom role covering the required rights must be created, or the security roles must be manually assigned. Otherwise, users will not have the permissions to use AttachmentExtractor.
- Use SharePoint compatibility connection: When enabled, improves performance with the SharePoint connection.
- Note: This requires SharePoint 2013 or higher and native REST endpoint communication.
3. License
In the License tab, you will be provided with an overview of the installed license. Furthermore, you can install a new license here. DocumentsCorePack is delivered with a fully supported, 14-day trial license.
- Clear License Cache: Clear your license cache.
- Subscription Number: Enter or change your Subscription ID.
- User roles: View information regarding user roles.
4. Version Info
In the Version Info tab, you can see an overview of your Dynamics 365 (CRM), Service and Management versions. With a click on the Reinstall/Upgrade button in the top left corner, you can reinstall or upgrade your version.
5. Progress and History
The Progress and History tab displays an overview of your file extraction history, showing the number of notes processed, emails processed, and so on. The Progress tab displays a list of extracted items. The Failures and Body failures tab displays the history of your failed items.
6. Extraction Analysis
In the Extraction Analysis tab, you can analyze and view the details of extracted records. In either the Extraction Analysis or Single Item Extract sub tab, you can analyze a record under the Add Extraction Analysis (or Add Single Item Extract) button by providing its URL.
When the analysis is finished, you can select an item to view its details.
7. Analyze Dataverse
In the Analyze Dataverse tab, you can view reports that detail the overall memory consumption of your tables in your environment. A report can be generated by clicking on the Start Analysis button.
Each report breaks down the memory consumption, displaying the size and number of rows of each individual table. This can help give an idea of how much space can be saved with AttachmentExtractor.
8. Service Logs
The Service Logs tab provides valuable insights into service health. This information is mainly used by our support team to gain information about the service.
Please note: Service logs are only kept for an interval of about 14 days.
That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com.