You may find information about the first steps necessary to your own storage connection with the help of KGS SAPALink SDKs.
The KGS SAPALink SDK was developed for customers which already use their own DMS archive / storage and wish to extend it with SAP connection abilities. Two options exist in order to create that kind of connection:
You will have to implement the given method bodies.
This includes methods like LinkOpen to open a connection to your own archive or all required functions for CREATE.
KGS ContentServer4Storage plays a central role within this process.
SAP System ↔ KGS ContentServer4Storage ↔ (Generic Storage Provider) ↔ SAPALINK-Implementation ↔ Store/DMS of the customer
Das KGS SAPALink SDK ist im Downloadbereich https://download.kgs-software.com/ (Version SAPALink_SDK_v210H.zip)zu finden.
The ZIP file contains the following:
Beschreibung:
componentCreateCOLD ist veraltet ("depreceated") und wird in der OSGi-ContentServer-Version nicht mehr unterstützt ! |
2. Runtime:
3. SAPALINK
4. SAPALINK.JAVA
5. SAPALINKTEST
6. TestDocuments
a.)
Der von KGS bevorzugte Weg den Kunden mit der SAPALink Implementierung zu unterstützen ist der Weg mit Java und dem aktuellen OSGi-Container. Hierzu müssen die Klassen "SAPALink.java" sowie "DMSException.java" aus dem Ordner SAPALINK.JAVA (siehe oben) implementiert werden. In dieser Anleitung wird ein Beispiel zu den (simplen) Methoden "infoGetVendorName()" und "infoGetProductName()" ausimplementiert.
In den Klassen stehen neben den Methodenrümpfen auch als Kommentar die Funktion, den Rückgabewert und ggf. Parameter.
// --------------------------------------------------------------------
// Function: infoGetVendorName
//
// Returns the vendor’s name as a String.
// Parameters: none
// Returncode: vendor’s name --> String
// --------------------------------------------------------------------
public String infoGetVendorName() throws DMSException
{
String csRet = null;
return csRet;
} |
Wie zu sehen ist, wird hier der VendorName (Herstellername) des anzubindenen Archives abgefragt. Hier kann der Kunde einen beliebigen Namen zurückgeben. Zb. "Max Mustermann AG".
public String infoGetVendorName() throws DMSException
{
return "Max Mustermann AG";
} |
Es wird dringend empfohlen auf Sonderzeichen zu verzichten (sowie UTF-8) zu nutzen. |
Widmen wir uns nun dem Produktname zu. Auch dieser kann beliebig sein.
// --------------------------------------------------------------------
// Function: infoGetProductName
// Returns the name of the product (DMS) as a String.
// Parameters: none
// Returncode: product name --> String
// --------------------------------------------------------------------
public String infoGetProductName() throws DMSException
{
String csRet = null;
return csRet;
} |
Ein Beispiel wäre "Magic Archive".
public String infoGetProductName() throws DMSException
{
return "Magic Archive";
} |
Zum Testen sollten auch die Methoden "infoGetProductVersion" sowie "infoGetLinkVersion" ausimplementiert werden.
b) Kompilieren
dies Javaklasse "SAPALink.java" können wir nun mithilfe eines beliebigen Java SDKs kompilieren. Dies ist entweder über eine IDE oder über die CommandLine möglich. Zu verkürzung wird hier über die Windows Command Line gearbeitet (die Befehle sind analog zu Unix).
Das ein Java SDK bereits auf dem System installiert und lauffähig ist wird vorrausgesetzt. Es wird in den Ordner via CommandLine mit der Javaklasse navigiert und mit dem Befehl "javac SAPALink.java" die Klasse(n) kompiliert:
Es sollten nun zwei weitere Dateien in dem Ordner vorhanden sein: SAPALink.class und DMSException.class.
Es wird eine standardinstallation des KGS ContentServers (auf OSGi-Basis) vorrausgesetzt.
Alle hier vorgeführten Oberflächenkonfigurationen (per WebGUI) können auch per Config-Files umgesetzt werden. |
Als erstes Navigieren wir per WebGUI in den OSGi-Containers des KGS ContentServers. Von dort aus navigieren wie zu der Konfiguration des Generic Store Services (des Bundles KGS Generic SAPALink Provider).
Hier konfigurieren wir zwei Parameter: Der Implementierungspfad und ein Flag bezüglich der nutzung von einer externen SAPALink Implementierung. Konkret sind das die Parameter: "Implementation Folder" und "Use internal Implementation".
Der Implementation Pfad muss auf den Ordner zeigen, in dem unsere kompilierten Klassen (SAPALink.class und DMSException.class) liegen. "Use internal Implementation" muss auf "false" gestellt werden.
"true" (default) würde immer die KGS Store Implementierung (und somit per Konfiguration aus der Storage.conf) auswählen.
Nun starten wir den Webserver neu.
Nach einem Neustart sollten wir nun in der Oberfläche des KGS ContentServers unsere Änderungen sehen:
dies sollte sich auch in der SAPALink Info (Unter "Main → SAPALink Info" wiederspiegeln):
Auch der ArchiveLink Befehl "serverInfo" sollte uns nun das gewünschte Resultat bereitstellen:
http://localhost:8080/KGSAdmin-CS/contentserver?serverInfo&pVersion=0046&resultAs=ascii
The content by label feature displays related articles automatically, based on labels you choose. To edit options for this feature, select the placeholder below and tap the pencil icon.
|