Connector für M-Files - Troubleshooting

Connector für M-Files

Request Tracing

Zur Fehleranalyse können die M-Files Anfragen und Antworten in der Portal-Logdatei protokolliert werden. Die portal.log-Datei finden Sie im Portalverzeichnis /log. Aktiviert wird das Tracing wie folgt:
  1. Öffnen Sie die log4j2.xml-Datei im Portalverzeichnis /internal/cfg mit einem Texteditor Ihrer Wahl.
  2. Navigieren Sie zum Logging for M-Files-Abschnitt und ändern Sie den level-Wert von info auf debug: 
    <!-- logging for M-Files -->
        <Logger name="de.uplanet.lucy.server.mfiles.connector" level="info" additivity="false">
            <AppenderRef ref="DailyFile"/>
        </Logger>
  3. Führen Sie einen Neustart des Portal-Dienstes durch.
Bei jeder M-Files-Aktion werden nun die Request-Details in der portal.log-Datei protokolliert. Hier ein Beispiel für einen Request/Response Tracing Eintrag: 
DEBUG MFilesHttpRequest[WebConnectorWorker-localhost:8102-3]
M-Files request: http://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-Verbindungen

Für SSL-Verbindungen zwischen dem Intrexx Portal Server und einem M-Files-Service muss das Zertifikat der Certificate Authority, die das Service Zertifikat ausgestellt hat, dem Zertifikatsspeicher des Intrexx Portal Servers hinzugefügt worden sein. Eine Ausnahme bilden selbstsignierte Zertifikate, die nicht von einer bekannten Certificate Authority ausgestellt wurden. Um SSL-Verbindungen zu Diensten mit selbstsignierten Zertifikaten zu ermöglichen, muss in diesem Fall im Intrexx Server die Prüfung der Certificate Chain deaktiviert werden. Dies ist auf Service-Ebene über eine System Property möglich. Öffnen Sie dazu die portal.cfg-Datei im Portalverzeichnis /internal/cfg mit einem Texteditor und fügen Sie dem <environment>-Abschnitt einen neuen <systemProperty>-Eintrag hinzu: 
<systemProperty name="de.uplanet.lucy.server.mfiles.connector.ignoreServerCertificates" value="true"/>
Nach dem Speichern der portal.cfg-Datei muss der Portal-Dienst neu gestartet werden, damit die Änderungen wirksam werden.

Weitere Informationen

Connector für M-Files
M-Files-Daten konsumieren
M-Files-Daten in Applikationen einbinden
M-Files in Prozessen
Export / Import