The configuration can be done by environment variables or by a yaml configuration file. For more complex scenario the yaml is recommended.
Global Environment Variables
...
Configuration
...
Required
...
Description
...
tia.destinations.saphttp.host
...
...
Hostname of the server with the ContentServer
...
tia.destinations.saphttp.port
...
...
Port of the ContentServer usually 80 or 443
...
tia.destinations.saphttp.protocol
...
...
Protocol of the contentserver http or https
...
tia.destinations.saphttp.path
...
...
Context Path of the server usually /contentserver
Global OPENID Configuration
...
Configuration
...
Required
...
Description
...
spring.security.oauth2.csrf.enabled
...
...
should be false
...
spring.security.oauth2.client.provider.azure.issuer-uri
...
...
Usually https://login.microsoftonline.com/<tenant>/v2.0
...
spring.security.oauth2.client.provider.azure.user-name-attribute
...
...
Defines where in the token the username can be found, usually name
...
spring.security.oauth2.client.registration.azure-login.provider
...
...
The provider that should be used. Should be azure
...
spring.security.oauth2.client.registration.azure-login.client-id
...
...
The public identification of the application, the ClientId
...
spring.security.oauth2.client.registration.azure-login.client-secret
...
...
The client secret for the application
...
spring.security.oauth2.client.registration.azure-login.scope[0]
...
...
fixed value openid
...
spring.security.oauth2.client.registration.azure-login.scope[1]
...
...
fixed value email
...
spring.security.oauth2.client.registration.azure-login.scope[2]
...
...
fixed value profile
Instance Variables
All instance variables are optional and there is no configuration required. Use the default profile in this case. You can also override the default profile with your own configuration or create new instances. Only changed parameter should be in the configuration.
configurations are overritten in there levels:
global default
default instance configuration
specific instance configuration
Example:
Global inbuild default: documentNote is true. (notes can be created in documents.
default configuration override: tia.instances.default.documentNote is false. Inbuild default is overritten and notes are global disabled
Finance configuration allows notes: tia.instances.finance.documentNote is true. When the instance finance is used the notes can be applied and displayed.
...
Configuration
...
Default
...
Description
...
tia.instances.<instance>.documentNote
...
true
...
When activated, the note button in the frontend is visible and can be used.
...
tia.instances.<instance>.printDocumentNoteDefault
...
true
...
Default value for the modal print dialog. When Activated the checkbox is prefilled, otherwise checkbox is not selected.
...
tia.instances.<instance>.documentNoteOpenMode
...
"closed"
...
This option control the note area opening behavior when opening a document:
closed - note area is always closed
open if note available - note is opened on show document when a note exists
always open - note area is always open
...
tia.instances.<instance>.docNoteModalResize
...
true
...
when active a user can reside the notes modal
...
tia.instances.<instance>.docNoteModalPrefWidth
...
400
...
Default width of the document notes modal dialog.
...
tia.instances.<instance>.docNoteModalPrefEditHeight
...
150
...
default high of the notes modal
...
tia.instances.<instance>.printDocumentNote
...
true
...
If this option is activated, users can print the document note.
...
tia.instances.<instance>.openEditAtStart
...
false
...
If this option is activated, edit mode is automatically entered when a document is opened.
...
tia.instances.<instance>.docNoteFontSize
...
12
...
Default font size for notes
...
tia.instances.<instance>.autoTurnOffEditMode
...
false
...
Automatically turns of the Edit mode in case the document has been saved.
...
tia.instances.<instance>.annotationLineSize
...
5
...
default size of the annotation lines
...
tia.instances.<instance>.checkmarkHeight
...
23
...
default high of the checkmark annotation
...
tia.instances.<instance>.checkmarkColor
...
rgb(0,0,0)
...
default color of the checkmark
...
tia.instances.<instance>.sidebarViewOnLoad
...
0
...
If this option is activated (1), the thumbnail is automatically displayed when a document is opened.
...
tia.instances.<instance>.drawCheckmark
...
true
...
If this option is activated, users can draw checkmarks
...
tia.instances.<instance>.downloadDocument
...
true
...
tia.instances.<instance>.drawText
...
true
...
tia.instances.<instance>.drawFreehand
...
true
...
tia.instances.<instance>.showDocStructure
...
true
...
tia.instances.<instance>.editMode
...
true
...
tia.instances.<instance>.checkmarkWidth
...
36
...
tia.instances.<instance>.annotationMouseoverTimeout
...
2000
...
tia.instances.<instance>.drawHighlight
...
true
...
tia.instances.<instance>.drawArrow
...
true
...
tia.instances.<instance>.disableFullscreen
...
true
...
tia.instances.<instance>.printAnnotationsDefault
...
true
...
tia.instances.<instance>.editOther
...
true
...
tia.instances.<instance>.drawStamp
...
true
...
tia.instances.<instance>.notificationTimeout
...
5000
...
tia.instances.<instance>.showAnnotationHistory
...
true
...
tia.instances.<instance>.checkmarkLineSize
...
5
...
tia.instances.<instance>.drawRedaction
...
true
...
tia.instances.<instance>.annotationFontSize
...
12
...
tia.instances.<instance>.drawRectangle
...
true
...
tia.instances.<instance>.printAnnotations
...
true
...
tia.instances.<instance>.annotationLineColor
...
rgb(0,0,0)
...
tia.instances.<instance>.downloadAnnotationsDefault
...
true
...
tia.instances.<instance>.showOleList
...
true
...
tia.instances.<instance>.docNoteModalPrefHistHeight
...
300
...
tia.instances.<instance>.emailDocument
...
true
...
tia.instances.<instance>.annotationFontColor
...
rgb(0,0,0)
...
tia.instances.<instance>.drawCircle
...
true
...
tia.instances.<instance>.showWatermark
...
true
...
tia.instances.<instance>.printDocument
...
true
...
tia.instances.<instance>.drawLine
...
true
...
tia.instances.<instance>.docNoteModalMinEditHeight
...
50
...
tia.instances.<instance>.downloadDocumentNoteDefault
...
true
...
tia.instances.<instance>.docNoteModalMinHistHeight
...
150
...
tia.instances.<instance>.docNoteModalMinWidth
...
300
...
tia.instances.<instance>.drawSticky
...
true
...
tia.instances.<instance>.sap.username
...
tia.instances.<instance>.sap.url
...
tia.instances.<instance>.sap.passwort
...
tia.instances.<instance>.watermark.text
...
tia.instances.<instance>.stamps.locations
...
tia.instances.<instance>.secKey
...
ABC123
...
tia.instances.<instance>.viewerEnabled
...
true
...
tia.instances.<instance>.mimetypes
...
| Code Block |
|---|
"application/pdf",
"image/tiff",
"image/tif",
"image/jpeg",
"image/jp2",
"image/png" |
Configuration by environment variables
...
tia® Viewer Core is configured using configuration parameters. There are different ways to specify them, described here: https://kgs-software.atlassian.net/wiki/x/FAALxw .
There are two categories of configuration parameters:
Global settings apply to the tia® Viewer Core instance, and
Instance settings apply to named instances, so configurations can be mapped to repositories, respectively to business objects and document types (SAP Customizing only, see Customize by repository respective business object and document type).