ELO connections
- Thomas Körbler
This page explains how Portrait can be connected to a given ELO archive.
Prerequisites
Before you can use ELO as a source for Portrait, we need to make sure that the following prerequisites are met.
ELOoffice is not supported - only ELOprofessional or ELOenterprise can be connected.
ELO Server
Portrait will access the ELO instance via ELO Indexserver. Make sure the Portrait-App Instance has direct access to the ELO Indexserver - this is especially relevant if the Portrait runs in a DMZ or external network.
The Indexserver communication works via HTTP/HTTPS. The needed URL is usually based on ELO server name and ELO archive name. Example given:
https://eloserver:9090/ix-Archive1/ixIn the given example, the Server is called eloserver and the repository Archive1.
Be aware that the URL is case-sensitive.
ELO Service-User
Create a specific user for the Portrait - we recommend the name PortraitService, since it is as service user only used for Portrait.
Don't set this user rights, because it acts as a limiter:
ELOxc Client Benutzer, nur E-Mails
DMS Desktop Benutzer, keine Workflows
Above-mentioned permissions are global permissions. Keep in mind that permissions inside the ELO Archive must be checked as well.
Set up a connection
Inside the application.yml file, we need to add a new entry inside the connections section:
connections:
connection:
- id: ix-Archive1
type: ELO
url: 'https://eloserver:9090/ix-Archive1/ix'
username: PortraitService
password: 's3cur3d'
timeoutInSeconds: 5
runAs:You can have several connections, each of them must start with a “-”.
The yml-file is formatted with white spaces. Ensure you have the correct indentation: first level = 2 white spaces, second level = 4 white spaces, and so on. You will get an error in the logs at startup if the YML is malformed.
After you added the connection, you can jump to the next chapter: ELO sources.
Properties
timeoutInSeconds: optional, default value is 5