Connector for M-Files - Troubleshooting

Request tracing

For error analysis, the M-Files requests and replies can be logged in the portal log file. The portal.log file can be found in the portal directory /log. Tracing is activated as follows:

  1. Open the “log4j2.xml" file from the portal directory /internal/cfg in a text editor.

  2. Navigate to the "logging for M-Files" section and change the value from INFO to DEBUG:

    <!-- logging for M-Files -->        
    	<Logger name="de.uplanet.lucy.server.mfiles.connector" level="info" additivity="false">            
    		<AppenderRef ref="DailyFile"/>        
    	</Logger>
  3. Restart the portal service.

For each M-Files action, the request details will now be logged in the portal.log file. Example of a request/response tracing entry:

DEBUG MFilesHttpRequest[WebConnectorWorker-localhost:8102-3]
M-Files request: https://mfiles/REST/objects/0/112/latest
DEBUG MFilesHttpRequest[WebConnectorWorker-localhost:8102-3]
M-Files response: {"Title":"Test1","EscapedTitleWithID":"Test1(ID 112)","DisplayID":"112","ObjVer":{"Version":4,"ID":112,"Type":0}

SSL connections

For SSL connections between the Intrexx portal server and an M-Files service, the Certificate Authority that provided the service certificate must be added to the certificate store of the Intrexx portal server. Self-signed certificates are an exception to this, which are not provided by a recognized Certificate Authority. In order to enable SSL connections to services with self-signed certificates, the check on the "certificate chain" must be deactivated. This is possible at the service level via a system property. To do so, open the portal.cfg file in the portal directory /internal/cfg file in a text editor and add a new <systemProperty> entry to the <environment> section:

<systemProperty name="de.uplanet.lucy.server.mfiles.connector.ignoreServerCertificates" value="true"/>

After saving the "portal.cfg" file, the Intrexx portal service must be restarted so that the changes take effect.

More information

Connector for M-Files
Consume M-Files data
M-Files in applications
M-Files in processes
Export / Import