SAPERION ECM C/ Link for SAP
Copyright © 2016 Lexmark. All rights reserved.
Lexmark is a trademark of Lexmark International, Inc., registered in the U.S. and/or other countries. All other trademarksare the property of their respective owners. No part of this publication may be reproduced, stored, or transmitted in anyform without the prior written permission of Lexmark.
Table of Contents
1 Introduction ......................................................................................................... 1
1.1 Technical Process ................................................................................................ 1
2 Installation and Configuration ............................................................................ 1
2.1 Requirements ....................................................................................................... 1
2.2 Scope of Delivery ................................................................................................ 2
2.3 "SilentFeature.ini" ................................................................................................ 2
2.4 Installation ........................................................................................................... 3
2.5 Configuration Index Form ................................................................................... 3
2.6 Login to SAPERION ............................................................................................ 4
2.7 Configuration SAP System .................................................................................. 4
2.8 SAP System Maintenance ................................................................................... 4
3 Working with C/ Link .......................................................................................... 5
1.1 Technical Process
1
SAPERION ECM C/ Link for SAP
1 Introduction
SAPERION C/ Link allows you to archive documents in SAPERION with a SAP object via drag&drop on
a desktop link to the SAPERION Rich Client. There is also the option of rendering files into long term
formats (TIFF or PDF) before archiving.
This document contains the description of how to setup the system for this functionality
(SAPERION-side). The second part offers a detailed instruction of how to use C/ Link.
1.1 Technical Process
By means of this function the user is able to drop a document with SAP-configured file format on a
SAPERION C/ Link desktop symbol. Hereby a connection is built to the SAP system and authentication
is carried out.
The start of the SAP user interface is processed with transaction OAWD by an interactive RFC call. The
user then logs onto SAP system out of the SAPERION C/ Link application. SAPERION memorizes the
credentials for a specified time defined in the macro in order to avoid repeated input in short period
of time.
The user selects the SAP business object in the ArchiveLink transaction OAWD. By doing so the
unambiguous SAP object (e.g., FI booking voucher) including validation (display of receipt) is selected.
Confirming the document archiving the SAPERION index form is opened where the document is
previewed in original format or in a rendered format.
After the document is checked the user may complete the document archiving process.
2 Installation and Configuration
2.1 Requirements
The SAPERION C/ Link is based on the Rich Client, therefore the same requirements apply.
Basically, ArchiveLink is used in the SAP system in this context. You have to make settings for the
transaction OAWD.
2 Installation and Configuration
2
i The SAP user must have rights for executing RFC calls in order to be able to archive via C/ Link.
2.2 Scope of Delivery
For the use of C/ Link the following listed software components are made available.
In the "...\x86\scenario\addon\CLink" directory of the SAPERION DVD you will find the following
required SAPERION components:
+ DL_CmdLineArchive.bas: BAS-file with starting macro and rendering call.
+ DL_SAP_Credentials.QBE: Login form
+ DL_SAP_Transaction.QBE: Index form with document preview
+ DL_SAP_Credentials.DDC and DL_SAP_Systems.DDC:Database definitions
+ DL_SAP_Systems_i and DL_SAP_Systems_q: Index and query forms for maintenance of the SAP
system
In the "...\x86\components\SAPRLinkExtension" directory you will find the ZIP-file "Transport RLink
Extension SAP ERP 600.zip" which contains the required SAP transport.
+ /SAAG/EXT_CLINK: SAP transport with function group for the import on customer's SAP system.
2.3 "SilentFeature.ini"
Before installing C/ Link the "Template_SilentFeature.ini" file has to be adapted and renamed into
"SilentFeature.ini". This File can be found in the "...\x86" directory.
Example
[CLIENT]
SilentClient=TRUE
MMCSnapIns=TRUE
SAPERION_PDF=TRUE
SAPERION_BLACKICE=TRUE
CLIENT=TRUE
[CORE_SERVER]
S_CORE=<Server name>
S_CORE_IP=<IP-address>
S_LANGUAGE=German32.lng
[SYSTEM]
KEY=<License key>
SERIAL=<Serial no.>
[SHORTCUT]
2.4 Installation
3
CommandLine=archie32.exe
Cmd_Option=/RunScript:"DL_CmdLineArchive!CmdLineSaveToSAP"
Name=SAPERIONClient
Parameters of section [Shortcut]
Parameter Description
CommandLine Name of the SAPERION Client ("archie32.exe" as a general rule).
Cmd_Option Command line parameter to start the macro for the communication with SAP system.
Name Enter any name for the desktop link.
2.4 Installation
i In order to be able to install C/ Link you need administrator's rights.
The C/ Link installation is only executable via silent installation. Proceed as follows:
1. Create a new folder in the target installation directory on the server and release it.
2. Copy the complete folder "x86" from the SAPERION DVD into the newly created directory.
3. Adapt the "Template_SilentFeature.ini" file as instructed in the chapter before.
4. Create a new installation directory on the client, e.g., named "SAPCLink".
5. Copy the DLLs "librfc32u.dll" and "librfc32.dll" from "...\x86\Program
Files\SAPERION\Application" of the SAPERION installation DVD into this directory.
6. Start the installation via command line.
Example
msiexec.exe /i setup.msi INSTALLDIR="C:\<Installation direcrtory>" SILENT=TRUE /q /l*v
C:\myInstallation.log
After successful installation the desktop link symbol appears on your workplace (in this
example named "SAPERIONClient").
2.5 Configuration Index Form
For each document type you can specify whether a rendering into TIFF or PDF is required. The user is
then allowed to check the render result in the preview of the SAPERION index form prior to the final
archiving.
To render documents the function "Render_OnInitDialog" of the macro "DL_CmdLineArchive.bas" must
be defined as OnInit-event of the index form.
2 Installation and Configuration
4
i Please note that the localization of this index form can only be made directly via in the SAPERION
forms designer. Here, you have to replace the button text by the text of the required language.
2.6 Login to SAPERION
You can configure an automatic login via the properties of the created desktop symbol (e.g.,
/CurrentUser). If no automatic login has been set, the SAPERION login form appears.
2.7 Configuration SAP System
The SAPERION ECM C/ Link is based on SAP ArchiveLink transaction OAWD, therefore the customizing
has to be made here.
For each content repository defined in SAP which is archiving documents into a separate DDC, an own
ArchiveLink protocol has be specified. The protocol contains the DDC name.
Alternatively you can also set an index form for the preview of the document and for entering index data
before archiving. Especially, when the rendering option is required the index mask is necessary.
The following figure illustrates a possible definition of a protocol: files are copied into the database
definition SAPCLINK and index form SAPCLINK_I is retrieved when archiving.
Fig. 2–1: Example configuration SAP system
A detailed documentation of protocol customizing can be found in "SAPERION ECM R/ Link".
2.8 SAP System Maintenance
SAP Systems are maintained in the SAPERION C/ Link lookup table SAP_SYSTEMS. For this purpose
the appropriate index and query forms ("DL_SAP_Systems_q" und "DL_SAP_Systems_i") are available.
Following values for each SAP system must be populated:
+ SID
+ Application Server
+ System number
2.8 SAP System Maintenance
5
+ Tenant.
3 Working with C/ Link
In the following it is described how a file is dropped from explorer on the desktop symbol and then
archived as SAPERION document.
1. Move the adequate document to the desktop symbol with the left mouse button pressed.
2. By releasing the mouse button the login dialog opens for registration to the SAP system.
3. Under the "SAP System" tab you can select the appropriate application server.
4. Under the "Credentials" tab, enter your user name and password.
5. Click [OK]. The transaction OAWD opens for the selection of archiving settings.
Here, you can choose presettings and probably parameters for the business object.
6. Click on the symbol [Storing for subsequent entry]. The "Storing for subsequent entry"
dialog opens.
7. Click on [Green check mark] for confirmation. Optionally you can enter a note in the note
text field. Unless it is configured for the selected content repository an index form opens
where you can check the (rendered) document and enter additional index data.
3 Working with C/ Link
6
8. Enter the required index data. SAPDOCID is assigned automatically by the SAP system
after confirmation by the [OK] button.
Closing the SAPERION index form, the SAP system creates a new work item. In the status
bar at the bottom left of the SAP user interface the information is displayed.
9. Click now in the "Storing for subsequent entry" dialog the [Cancel] button in order to close
the dialog.
10. Terminate the SAP user interface so that the macro could be reinitialized.