This blog article describes how you can activate debug logging for the AutoMergeAzure Plugin. Activating logging can be useful for generating log files for our support team to review if you encounter issues while using the DocumentsCorePack Dialog or Template Designer Office Add-In.
Note: The AutoMergeAzure Plugin is relevant only for Dataverse (Dynamics 365 Online) organizations with a DCP Online Service created at mscrm-addons.com.
Step 1: Double-check if logs are already accessible
Depending on your environment settings, logging may already be enabled. In these cases, you can already recreate the issue and locate the log files under Power Platform Environment Settings -> Customization -> Plug-In Trace Log. Skip to “Step 4: Locate log files” for more information.
If the Plug-In Trace Log table is empty, however, you must proceed with the full walkthrough below.
Step 2: Enable logging to plug-in trace log
To enable logging, you first must enable tracing for your organization. This can be done in Dynamics 365 by navigating to Power Platform Environment Settings -> System -> Administration -> Customization.
Then, under Plug-in and custom workflow activity tracing, select All.
Step 3: Creating and configuring the “Plugin” record
With plug-in tracing activated, return to Power Platform Environment Settings and navigate to MSCRM-ADDONS -> Products. Check if a record named “Plugin” already exists. If not, create a new one by clicking the New button.
Enter the following values into the record:
- Name: Plugin
- Product Type: server
Save and close the record, then open it again. Under the MSCRM-ADDONS.com Settingskeys tab, click the New… button to create a new Settingskey.
Enter the following information:
- Name: debug
- Keyvalue: true
Save and close the Settingskey. This will active plugin logging.
Step 4: Locate log files
To generate log files, please attempt to recreate your issue via the DCP Dialog or DCP Template Designer Office Add-In. You can then access these log files by returning to Power Platform Environment Settings and navigating to Customization -> Plug-In Trace Log. Under Type Name, look for records starting with “PTM.Plugins.AutoMergeAzurePlugin”.
The log files can be found under the Execution tab in the Message Block field. Please send the support team (support@mscrm-addons.com) the content of this field.
Note: If the Message Block field is empty, this may mean that an error occurred. Please look at the Exception Details field below it for more detailed error information.
Step 5: Disabling logging
Once the issue is resolved, we recommend disabling logging via the Settingskey again. If desired, you may also set the Enable logging to plug-in trace log setting in Step 2 back to its original value.