Integration with LEXolution.FOMA

Integration with LEXolution.FoMa

The LEXolution server transfers all debt management-relevant data to LEXolution.FoMa.

Integration with LEXolution.FoMa is optional.
To use the LEXolution.FoMa integration, LEXolution.FoMa must be installed.
The installation and configuration of LEXolution.FoMa is not covered by these installation instructions.

Our support team (Support@stp-online.de) will be happy to assist you with the LEXolution.FoMa integration.

Configuring the LEXolution.FoMa integration

To configure the LEXolution.FoMa integration, follow these steps:

Step 1
Open the LEXolution server configuration file with administrator privileges. If you installed the LEXolution server in the default installation directory, the configuration file STP.Kms.Server.exe.config is located in the directory C:\Programme (x86)\STP AG\LEXolution.KMS-Server\.

Under IsFoMaEnabled, specify whether the LEXolution.FoMa integration is enabled. The default value is 0 (disabled).

<add key="IsFoMaEnabled" value="1"></add>.

Under FoMaServerAddress, specify the URL of the LEXolution.FoMa web shell.

<add key="FoMaServerAddress" value="http://localhost:44101/"></add>.

Under FoMaStsServerAddress, specify the URL of the LEXolution.FoMa StsServer.

<add key="FoMaStsServerAddress" value="http://localhost:44106/trust.svc/"></add>.

Under FoMaVersion, specify which version of LEXolution.FoMa is being integrated.
Enter "V2017" for LEXolution.FoMa 2017, or "V2015" otherwise.

<add key="FoMaVersion" value="V2017"></add>.

Under FoMa2017Domain, specify the domain of the LEXolution.FoMa technical user account.
This user must have import permissions in Ikaros.

<add key="FoMa2017ADDomain" value=""></add>

Under FoMa2017Benutzer, specify the username of the LEXolution.FoMa technical user account.
This user must have import permissions in Ikaros.

<add key="FoMa2017Benutzer" value=""></add>.

Under FoMa2017Passwort, specify the password for the LEXolution.FoMa technical user account.

<add key="FoMa2017Passwort" value=""></add>.

To transfer documents, the external communication interface must be enabled (see Chapter 2.9).

Step 2
Save your changes and close the configuration file.
Stop the STP LEXolution Server service and restart it. >> The updated settings have been applied.
The STP LEXolution Server service is running.
The LEXolution server is installed and configured.

If a LEXolution.FoMa integration was already enabled, disabling it may cause data inconsistencies if data is modified in KMS during the deactivation period and the FoMa integration is then re-enabled afterward.

1.10. Providing the External Communication Interface

The LEXolution server exposes an external communication interface via a web service, which allows several LEXolution functions to be controlled remotely.

The external communication interface is optional.
The configuration steps required to communicate with the web service are not covered by these installation instructions.

Configuring the external communication interface
To configure the external communication interface, follow these steps:

Step 1
Open the LEXolution server configuration file with administrator privileges. If you installed the LEXolution server in the default installation directory, the configuration file STP.Kms.Server.exe.config is located in the directory
C:\Programme (x86)\STP AG\LEXolution.KMS-Server\.
Under ExternalCommunicationServicePort, specify the port to be used for communication.
The default value is 8002.

<add key="ExternalCommunicationServicePort" value="8002"> </add>.

Under IsExternalCommunicationServiceEnabled, specify whether the communication interface should be enabled.
The default value is 0 (disabled).

<add key="IsExternalCommunicationServiceEnabled" value="1" ></add>

Under IsExternalCommunicationServiceSecured, specify whether the communication interface should use a secured connection.
The default value is 0 (disabled).

<add key="IsExternalCommunicationServiceSecured" value="0"> </add>

Under IsMtomForExternalCommunicationServiceEnabled, specify whether MTOM encoding should be used for the communication interface.
The default value is 0 (disabled).

<add key="IsMtomForExternalCommunicationServiceEnabled" value="0"></add>

Step 2
Save your changes and close the configuration file.
Stop the STP LEXolution Server service and restart it.
- The updated settings have been applied. - The STP LEXolution Server service is running. - The LEXolution server is installed and configured.

To be able to remotely control LEXolution functions for case files with restricted object permissions, the user account under which the third-party software or service runs must exist in LEXolution as an administrator.
Via the communication interface, access is only possible to the case files for which the user account running the third-party software or service also has object permissions.

If you want to use a secured connection for the external communication interface (key="IsExternalCommunicationService Secured" value="1"), you must ensure that this is supported by all communication partners (web services).

If you want to use MTOM encoding for the external communication interface (key="IsMtomForExternalCommunicationServiceEnabled" value="1"), you must ensure that this is supported by all communication partners.
MTOM encoding optimizes the transfer of objects by transmitting them in binary format rather than as XML text.