| Table of Contents | ||
|---|---|---|
|
This section describes the SAP-side customization when using tia tia® Viewer Core in SAP-side customized tia tia® Viewer Core configuration. Among other settings, the mapping of repositories to tia tia® Viewer URLs and its instances resides here.
tia tia® Viewer Core requires web service. This is included in the transport below. Its activation is described here: https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/edit-v2/3257106464#Web-service-for-tia-Viewer Activation of web service for tia® Viewer Core.
Prerequisite is importing the Viewer SAP transport container. It is available in kgs Members Area in section tia® H5 Viewer.
Container transport number: E23K900055, tia H5 Viewer Version 3.0.0 .
| Info |
|---|
Please note: SAP-User for KGS Components |
...
Exit-Module, TOAEX SAP Table
Before executing kgs customizing, the exit module for document retrieval must be registered.
After registration, the exit module is executed each time a document is retrieved. If the module cannot recognize kgs customizing information that causes the tia Viewer to start, the SAP ArchiveLink default setting is used.
The following must be entered in the TOAEX standard table:
...
EXIT ID
...
S
...
Function module
...
OA_OBJECTDISPLAY_01
...
X
...
/KGS1/CALL_VIEWER
...
(Transaction SE16n → Table TOAEX, Exit ID: OA_OBJECTDISPLAY_01)
/KGS1/VIEWER_CUST transaction
The transaction /KGS1/VIEWER_CUST grants access to client-specific adjustment by content repository on how the system calls the tia Viewer.
...
(Transaction /KGS1/VIEWER_CUST)
The table contains the following information:
...
Parameter
...
Description
...
Cont. Rep.
...
Content Repository ID
...
HTTP server
...
Host name or IP address of the web server on which the tia Viewer is hosted.
...
Port
...
Port number for accessing the web server.
...
HTTP Script
...
Web context of the tia Viewer.
...
Viewer Conf
...
Name of the tia Viewer instance to be used for this repository. Instance default is used, when empty.
...
active/inactive
...
Customizing activated/deactivated.
...
https
...
Activate or deactivate SSL communication with tia Viewer.
...
...
Activate or deactivate tia Viewer for displaying PDF documents.
...
TIF
...
Activate or deactivate tia ViewerI for displaying TIF documents.
...
JPG
...
Activate or deactivate tia Viewer for displaying JPG documents.
...
MimeType
...
If activated, the system performs an INFO request first to determine the MIME type before displaying the document. Activation increases the load on the archive server, while ignoring the MIME type specification in ArchiveLink information. Default is deactivated.
...
CompID
...
If activated, the system performs an INFO request to determine the component id before displaying the document, instead of defaulting to component id data. Activation increases the load on the archive server. Default is deactivated.
/KGS1/VIEWER_DOCTY transaction
The transaction /KGS1/VIEWER_DOCTY, grants access to client-specific adjustment by business object and document type on how the system calls the tia Viewer.
Customizing it is optional, and can be done in combination with customizing via /KGS1/VIEWER_CUST transaction.
/KGS1/VIEWER_PARAM transaction / secret token
Use the transaction /KGS1/VIEWER_PARAM for following configurations:
Storing the token password
Defining, whether the call of the tia Viewer shall check an authorization object
To define the installation path / paths to browsers
The following entries are possible:
...
ID
...
Parameter
...
Description
...
01
...
Token Password
...
Type: String
| Info |
|---|
The password must match the setting in tia Viewer side configuration. See parameter |
...
02
...
Check Viewer Authorization
...
Type: Boolean
If activated, the authorization object is checked user and group access rights.
These access rights are combinations of c (create), r (read), u (update), d (delete).
...
03
...
Browser Path Chrome
...
Type: String
Optional: Path of the Chrome browser installation (.exe-file).
...
04
...
Browser Path Firefox
...
Type: String
Optional: Path of the Firefox browser installation (.exe-file).
...
05
...
Browser Path IE
...
Type: String
Optional: Path of the Internet Explorer browser installation (.exe-file).
...
06
...
Browser Path Edge
...
Type: String
Optional: Path of the Edge browser installation (.exe-file).
...
07
...
Browser Path Other
...
Type: String
Optional: Path of the other browser installation (.exe-file).
(Transaction /KGS1/VIEWER_PARAM )
The browser path specifications are then used by the user parameter /KGS1/CALL_BROWSER. This parameter can be modified by transaction SU3 for individual users or groups.
...
Example: Configuring default browser Firefox (parameter id 04) using transaction SU3.
...
/KGS1/SUPRESS_VIEWER user parameter
By SAP user parameter /KGS1/SUPRESS_VIEWER, the user can deactivate tia Viewer. This parameter can be set using transaction SU3.
...
BAdi /KGS1/VIEWER_WINDOW_NAME
The enhancement spot /KGS1/VIEWER_WINDOW_NAME allows to overwrite the default name for the window title and file download.
The default name is (<AR_OBJECT> specifies the document type, and <OBJECT_ID> the object id of SAP ArchiveLink):
<AR_OBJECT> <OBJECT_ID>
...
| Info |
|---|
All characters in file names must be allowed in the file system used. E.g. invalid characters for Windows filenames are:
|
| Note |
|---|
If the tia® Content Server (core) is used, the following parameter must be set in the
|
Badi implementation guide by SAP: https://help.sap.com/viewer/6f40b8f46c4b10149770d29604c9a4eb/7.01.22/en-US/44f518d884056c30e10000000a114a6b.html
Activation of web service for tia Viewer Core
Execute transaction SICF and press Execute button
...
In the Virtual Hosts / Services tree view find tia > tia_viewer.
Right-Click tia_viewer and select Activate Service of the context menu.
...
3. When being asked Do you want to activate service /default_host/tia/tia_viewer? , select Yes.
...
After the web service is activated and listens to following URL of your SAP-System:
| Code Block |
|---|
https://<sap-system>:<port>/tia/tia_viewer |
Right-Click tia_viewer again and select Test Service of the context menu.
The browser opens and shows followingbrowser will open and will show the following result.
| Code Block |
|---|
https://<sap-system>:<port>/tia/tia_viewer?sap-client=<client> |
...
The URL to call the document out of the archive with the corresponding secKey is returned:
| Code Block |
|---|
https://<archive-server>:<port>/contentserver?create&pVersion=<AL-Version>&contRep=<CR>&docId=<Doc-ID>&compId=<comp_id>&accessMode=c&authId=<SAP-Cerificate>&expiration=<expiration_time>&secKey=<secKey> |
Example:
This URL is included into the tia Viewer Core to display the archived document.