SAPERION ECM C/ Link für 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.

Inhaltsverzeichnis

1 Einführung ........................................................................................................... 1

1.1 Technischer Ablauf .............................................................................................. 1

2 Installation und Konfiguration ............................................................................ 1

2.1 Voraussetzungen ................................................................................................. 1

2.2 Lieferumfang ........................................................................................................ 2

2.3 "SilentFeature.ini" ................................................................................................ 2

2.4 Installation ........................................................................................................... 3

2.5 Konfiguration Indexmaske .................................................................................. 3

2.6 Anmeldung an SAPERION ................................................................................. 4

2.7 Konfiguration SAP System .................................................................................. 4

2.8 Pflege des SAP Systems ..................................................................................... 4

3 Arbeiten mit C/ Link ........................................................................................... 5

1.1 Technischer Ablauf

1

SAPERION ECM C/ Link für SAP

1 Einführung

Mit dem SAPERION C/ Link ist es möglich, mittels einer Desktop-Verknüpfung zum SAPERION Rich

Client Dateien per Drag&Drop auf diesen Link mit einem SAP-Objekt zu verknüpfen und in SAPERION zu

archivieren. Dabei können alle im SAP-System definierten Dateiformate abgelegt werden. Des Weiteren

besteht die Option, das abgelegte Dokument in ein gängiges Langzeitformat (TIFF oder PDF) zu rendern.

In diesem Dokument wird beschrieben, wie Sie das System (SAPERION-seitig) für diese Funktion

einrichten. Im zweiten Teil der Dokumentation wird die Bedienung näher erläutert.

1.1 Technischer Ablauf

Mit Hilfe dieser Funktion kann der Anwender ein Dokument mit SAP-konfiguriertem Dateiformat per

Drag&Drop auf dem SAPERION C/ Link Desktop-Symbol ablegen. Hierdurch wird eine Verbindung mit

dem SAP-System aufgebaut, wobei eine Authentifizierung gegenüber SAP erfolgt.

Der Aufruf der SAP-Benutzeroberfläche erfolgt mit der Transaktion OAWD durch einen interaktiven

RFC-Aufruf. Aus der Anwendung SAPERION C/Link heraus meldet sich der Benutzer an SAP an.

SAPERION merkt sich die Anmeldedaten für eine im Makro festgelegte Zeit, um deren wiederholte

Eingabe innerhalb kurzer Zeiträume zu vermeiden.

Der Benutzer wählt anschließend das SAP Business-Objekt in der ArchiveLink-Transaktion OAWD aus.

Damit wird das eindeutige SAP-Objekt (z.B. FI Buchungsbeleg) inklusive Verifikation (Anzeige des

Belegs) selektiert. Durch Bestätigung der Dokumentenablage öffnet sich eine SAPERION Indexmaske,

in der das Dokument in Originalformat oder ggf. gerendert in der Vorschau angezeigt wird.

Nach Überprüfung des Dokuments kann der Anwender abschließend die Ablage bestätigen.

2 Installation und Konfiguration

2.1 Voraussetzungen

Der SAPERION C/ Link basiert auf dem Rich Client, daher gelten die gleichen Voraussetzungen.

Im SAP System wird grundsätzlich das ArchiveLink in diesem Kontext verwendet, Sie müssen daher

Voreinstellungen für die Transaktion OAWD vornehmen.

2 Installation und Konfiguration

2

i Voraussetzung für das Archivieren über C/ Link ist, dass SAP-Anwender über die Berechtigung

verfügen, RFC-Aufrufe auszuführen.

2.2 Lieferumfang

Für den Einsatz des C/ Links werden die im Folgenden aufgelisteten Software-Komponenten ausgeliefert.

Im Verzeichnis "...\x86\scenario\addon\CLink" der SAPERION DVD finden Sie die SAPERION

Komponenten:

+ DL_CmdLineArchive.bas: BAS-Datei mit dem Startmakro und Rendering-Aufruf.

+ DL_SAP_Credentials.QBE: Anmeldemaske

+ DL_SAP_Transaction.QBE: Indexmaske mit Dokumentenvorschau

+ DL_SAP_Credentials.DDC und DL_SAP_Systems.DDC: Datenbankdefinitionen

+ DL_SAP_Systems_i und DL_SAP_Systems_q: Index- und Abfragemaske zur Pflege des SAP Systems

Im Verzeichnis "...\x86\components\SAPRLinkExtension" der SAPERION DVD finden Sie die ZIP-Datei

"Transport RLink Extension SAP ERP 600.zip", die den benötigten SAP Transport enthält.

+ /SAAG/EXT_CLINK: SAP Transport mit Funktionsgruppe zum Import auf Kunden SAP-System.

2.3 "SilentFeature.ini"

Bevor Sie die Installation des C/ Links ausführen, muss die Datei "Template_SilentFeature.ini" angepasst

und in "SilentFeature.ini" umbenannt werden. Diese Datei finden Sie im Verzeichnis: "...\x86" der

SAPERION Installations-DVD.

Beispiel

[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.>

2.4 Installation

3

[SHORTCUT]

CommandLine=archie32.exe

Cmd_Option=/RunScript:"DL_CmdLineArchive!CmdLineSaveToSAP"

Name=SAPERIONClient

Parameter der Sektion [Shortcut]

Parameter Beschreibung

CommandLine Name des SAPERION Clients (in der Regel "archie32.exe").

Cmd_Option Kommandozeilenparameter zum Start des Makros für die Kommunikation mit SAP.

Name Geben Sie der Desktop-Verknüpfung (Link) einen beliebigen Namen.

2.4 Installation

i Um eine C/ Link-Installation ausführen zu können, benötigen Sie Administrationsrechte.

Die C/ Link-Installation ist nur über eine Silent Installation ausführbar. Gehen Sie wie folgt vor:

1. Legen Sie einen neuen Ordner in dem Ziel-Installationsverzeichnis auf dem Server an und

geben Sie diesen frei.

2. Kopieren Sie den Ordner "x86" von der SAPERION DVD in das neu angelegte Verzeichnis.

3. Passen Sie die Datei "Template_SilentFeature.ini" wie oben beschrieben an.

4. Legen Sie nun auf dem Client ein Installationsverzeichnis an, z.B. "SAPCLink".

5. Kopieren Sie die DLLs "librfc32u.dll" sowie "librfc32.dll" aus dem Verzeichnis

"...\x86\Program Files\SAPERION\Application" der SAPERION Installations-DVD in den

neu angelegten Ordner.

6. Starten Sie die Installation über die Kommandozeile.

Beispiel

msiexec.exe /i setup.msi INSTALLDIR="C:\<Installation direcrtory>" SILENT=TRUE /q /l*v

C:\myInstallation.log

Nach erfolgreicher Installation erscheint das Desktop-Symbol (in diesem Beispiel

"SAPERIONClient") auf Ihrer Arbeitsfläche.

2.5 Konfiguration Indexmaske

Für jeden Dokumenttyp können Sie einstellen, ob Dokumente diesen Typs nach TIFF oder PDF gerendert

werden sollen. Der Anwender hat dann die Möglichkeit, das Renderergebnis vor der endgültigen Ablage

in der Vorschau der SAPERION-Indexmaske zu überprüfen.

Damit Dokumente gerendert werden, muss die Funktion "Render_OnInitDialog" des Makros

"DL_CmdLineArchive.bas" als "OnInit"-Event der Indexmaske definiert worden sein.

2 Installation und Konfiguration

4

i Bitte beachten Sie, dass eine Lokalisierung der verwendeten Indexmaske nur direkt über die

Bearbeitung im SAPERION Masken Designer erfolgen kann. Hier müssen Sie beispielsweise die

Beschriftung von Schaltflächen in die gewünschte Sprache umändern.

2.6 Anmeldung an SAPERION

Sie können über die Eigenschaften des erzeugten Desktop-Symbols eine automatische Anmeldung

konfigurieren (z.B. /CurrentUser). Ist keine automatische Anmeldung konfiguriert, wird der SAPERION

Anmeldedialog eingeblendet.

2.7 Konfiguration SAP System

Der SAPERION ECM C/ Link basiert auf SAP-Seite auf der SAP ArchiveLink Transaktion OAWD, somit

muss das Customizing auch entsprechend erfolgen.

Für jedes in SAP definierte Content Repository, welches Dokumente in eine separate DDC archiviert,

muss ein eigenes ArchiveLink-Protokoll spezifiziert werden, in welchem der DDC-Name angegeben ist.

Alternativ kann auch eine Indexmaske angeben werden, mit welcher eine Vorschau des Dokuments

aufgeblendet und Indexwerte bei der Ablage eingegeben werden können. Vor allem wenn ein Rendern

der Dokumente in ein Langzeitformat gewünscht ist, ist das Einbinden einer Indexmaske mit

Dokumentenvorschau notwendig.

Die folgende Abbildung zeigt eine mögliche Definition eines Protokolls, bei welchem Dateien in die

Datenbankdefinition SAPCLINK abgelegt und bei der Ablage die Indexmaske SAPCLINK_I aufgerufen

wird.

Abb. 2–1: Beispielkonfiguration im SAP System

Eine ausführliche Dokumentation zum Customizing der Protokolle ist in der Dokumentation

"SAPERION ECM R/ Link" zu finden.

2.8 Pflege des SAP Systems

Die SAP Systeme werden in der SAPERION C/ Link Nachschlagetabelle SAP_SYSTEMS gepflegt. Hierfür

stehen die zugehörigen Index- und Abfragemasken ("DL_SAP_Systems_q" und "DL_SAP_Systems_i")

zur Verfügung.

Folgende Werte pro SAP System müssen eingepflegt werden:

2.8 Pflege des SAP Systems

5

+ SID

+ Application Server

+ Systemnummer

+ Mandant.

3 Arbeiten mit C/ Link

Im Folgenden wird beschrieben, wie eine Datei aus dem Explorer auf das Desktop-Symbol gezogen und

anschließend als SAPERION Dokument archiviert wird.

1. Ziehen Sie mit gehaltener linker Maustaste das Dokument, das Sie archivieren möchten,

auf das Desktop-Symbol.

2. Durch Loslassen der linken Maustaste öffnet sich der Dialog zur Anmeldung an das SAP

System.

3. Wählen Sie in der Registerkarte "SAP System" den passenden Application Server aus.

4. Geben Sie unter der Registerkarte "Credentials" Ihren Benutzernamen sowie Passwort ein.

5. Klicken Sie [OK]. Die Transaktion OAWD öffnet sich zur Auswahl der Ablageeinstellungen.

Hier können Sie die Voreinstellungen wählen und ggf. die Parameter für das Business

Objekt angeben.

6. Klicken Sie auf das Symbol [Storing for subsequent entry]. Der Dialog "Storing for

subsequent entry" öffnet sich.

3 Arbeiten mit C/ Link

6

7. Klicken Sie auf die Schaltfläche [Grünes Häkchen] zur Bestätigung. Optional können Sie

eine Notiz in das dafür vorgesehene Textfeld eingeben.

Sofern dies im ausgewählten Content Repository konfiguriert wurde, wird eine

Indexmaske zur Überprüfung des (gerenderten) Dokuments und der zusätzlichen Eingabe

von Indexwerten geöffnet.

8. Geben Sie die erforderlichen Indexdaten ein. Die SAPDOCID wird durch Bestätigung mit

der Schaltfläche [OK] vom SAP-System automatisch vergeben.

Mit dem Schließen der SAPERION Indexmaske legt das SAP-System ein neues Work Item

an. Dies wird in der Statusleiste der SAP-Benutzeroberfläche links unten angezeigt.

9. Klicken Sie im Dialog "Storing for subsequent entry" auf die Schaltfläche [Cancel], um

diesen zu schließen.

2.8 Pflege des SAP Systems

7

10. Schließen Sie die SAP Benutzeroberfläche, so dass das Makro neu initialisiert werden

kann.