Connecting to Lexolution.FOMA

Connecting to LEXolution.FoMa

The Lexolution server transfers all claim management-related data to LEXolution.FoMa.

Connecting to LEXolution.FoMa is optional.
To use the connection to LEXolution.FoMa, LEXolution.FoMa must be installed.
The installation and configuration of LEXolution.FoMa are not part of this installation guide.

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

Configure connection to LEXolution.FoMa

To configure the connection to LEXolution.FoMa, follow these steps:

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

Under IsFoMaEnabled, specify whether the connection to LEXolution.FoMa should be used. The default value is 0 (disabled).

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

Under FoMaServerAddress, enter the URL of the LEXolution.FoMa Webshell.

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

Under FoMaStsServerAddress, enter 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 connected.
For LEXolution.FoMa 2017, enter the value “V2017”; otherwise, enter “V2015”.

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

Under FoMa2017Domain, enter the domain of the technical user for LEXolution.FoMa.
The user must have import rights in Ikaros.

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

Under FoMa2017Benutzer, enter the name of the technical LEXolution.FoMa user.
The user must have import rights in Ikaros.

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

Under FoMa2017Passwort, enter the password for the technical user of LEXolution.FoMa.

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

To transfer documents, the external communication interface must be enabled (see section 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 connection was already enabled, disabling it may lead to data inconsistencies if data is changed in KMS during the deactivation and then the FoMa connection is re-enabled afterwards.

1.10. Providing the external communication interface

The Lexolution server publishes 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 access the web service are not part of this installation guide.

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

Step 1
Open the configuration file for the Lexolution server with administrator rights. If you installed the Lexolution server in the default installation directory, the configuration file STP.Kms.Server.exe.config is located in
C:\Program Files (x86)\STP AG\LEXolution.KMS-Server\.
Under ExternalCommunicationServicePort, specify which port will 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 secure connection.
The default value is 0 (disabled).

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

Under IsMtomForExternalCommunicationServiceEnabled, specify whether encoding for the communication interface should use MTOM encoding.
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 remotely control functions within Lexolution for files with restricted object rights, the user account under which the third-party software/service runs must exist as an administrator in Lexolution.
Through the communication interface, access is only possible to files for which the user running the third-party software/service also has object rights.

If you want to use a secure connection for the external communication interface (key="IsExternalCommunicationServiceSecured" value="1"), make sure that all communication partners (web services) support this.

If you want to use MTOM encoding for the external communication interface (key="IsMtomForExternalCommunicationServiceEnabled" value="1"), make sure that all communication partners support this.
MTOM encoding optimizes the transfer of objects by transmitting them in binary format instead of as XML text.