1

einzelne Originaldateien von Dokumenten

Parameter werden über Dateien zwischen dem SAP-System und dem Konverter übergeben

2

einzelne Originaldateien von Dokumenten und Baugruppen

3

einzelne Originaldateien von Dokumenten und Baugruppen

Parameter werden über die RFC-Schnittstelle zwischen dem SAP-System und dem Konverter übergeben

Aufruf von ConvServSamp

Beim Aufruf von ConvServSamp müssen Sie folgende Parameter angeben:

RFC Parameter

Pfadnamen dershell-script-Datei, die von ConvServSamp zur Konvertierung gestartet werden soll (mit dem Parameter-s<shell-script Dateiname>)

Falls Sie außerdem den Parameter-readDocumentDetailsangeben, werden Informationen über das Dokument, das konvertiert wird, gelesen und als Dateien gespeichert.

Beispiele:

ConvServSamp -s c:\bat\StartConv.bat <RFC Parameter>

ConvServSamp -s $HOME/bin/StartConv <RFC Parameter>

ConvServSamp erzeugt <WorkingDirectory> /Parameters.txt

Die Datei <WorkingDirectory>/Parameters.txt wird vor dem Aufruf von StartConv erzeugt und enthält die Parameter, die im Customizing der Konvertierungsspezifikation gepflegt wurden. Diese Einstellungen erfolgen im Customizing der Konvertierung, unter Logistik Allgemein → Konvertierung → Konvertierung festlegen .

Zusätzliche Dateien

Folgende Dateien werden zusätzlich erzeugt, falls beim Aufruf von ConvServSamp der Parameter ‑readDocumentDetails angegeben wird:

<WorkingDirectory>/Documentdata.txt

<WorkingDirectory>/Ecmdata.txt

<WorkingDirectory>/Documentdescriptions.txt

<WorkingDirectory>/Longtexts.txt

<WorkingDirectory>/ClassData.txt

<WorkingDirectory>/Objectlinks.txt

<WorkingDirectory>/Statuslog.txt

<WorkingDirectory>/ExportData.txt

<WorkingDirectory>/UserData.txt

Die Dateien enthalten diejenigen Daten, die der FunktionsbausteinCAD_GET_TITLE_BLOCK_DATAermittelt. Informationen zum Inhalt der Dateien finden Sie in der Dokumentation zu diesem Funktionsbaustein (Export ParameterDOCUMENTDATAundECMDATAund TabellenDOCUMENTDESCRIPTIONS, LONGTEXTS, CLASS_DATA, OBJECTLINKS, STATUSLOG, EXPORT_DATAundUSER_DATA).

Die Dateien Documentdata.txt und Ecmdata.txt enthalten zu jedem Element der StrukturenDOCUMENTDATAbzw.ECMDATAeine Zeile, in der der Name und der Wert des Elementes angegeben werden: <Name> = <Wert> (Beispiel: DOCUMENTTYPE = DRW)

Alle anderen Dateien enthalten je Zeile der zugehörigen Struktur eine Zeile. Jede Zeile enthält pro Element der Struktur der Tabelle einen Wert. Die Zahl der Spalten richtet sich nach der im SAP-System definierten Breite. Es werden keine Begrenzer verwendet.

ConvServSamp setzt Parameterwerte für StartConv

Der Beispielserver ConvServSamp ruft die Datei StartConv auf:

StartConv <Version> <WorkingDirectory> <FileToConvert> <language> <ConverterTimeOut> <conversionName> <DocumentKey> <current_user_name> <sy_language>

ConvServSamp setzt für die Parameterwerte <WorkingDirectory><FileToConvert>, <DocumentKey>, <current_user_name> und <sy_language>jeweils am Anfang und Ende das Sonderzeichen" Damit wird die Interpretation von Sonderzeichen durch dieShellverhindert.

Jeder Konvertierung steht ein eigenes Verzeichnis (<WorkingDirectory>) zur Verfügung, in das die konvertierten Dateien geschrieben werden sollten.

Die Parameter haben folgende Bedeutung:

< Version> (z.B: 5): Angabe, welche Funktionen im aktuellen SAP-System unterstützt werden

<WorkingDirectory>: Arbeitsverzeichnis, beispielsweise für die konvertierten Dateien

<FileToConvert>: Datei, die konvertiert werden soll

<language>: Sprache für Fehlermeldungen ('X' => keine Sprache angegeben)

<ConverterTimeOut>: Nach dieser Zeit (in Minuten) sollte die Konvertierung abgebrochen werden.

<conversionName>: Eindeutiger Name für diese Konvertierung

<DocumentKey>: Schlüssel des Dokumentes in folgender Reihenfolge: 3 Zeichen: documenttype (Dokumentart) 25 Zeichen: documentnumber (Dokumentnummer) 3 Zeichen: documentpart (Teildokument) 2 Zeichen: documentversion (Dokumentversion)

<current_user_name>: Name des Anwenders, der die Konvertierung gestartet hat (implizit oder explizit)

<sy_language>: Sprache, die von <current_user_name> benutzt wird

Modifizieren der Datei StartConv

Verändern Sie die Beispieldatei StartConv so, daß

von dieser Datei Ihr Konverter gerufen wird und

eine der Dateien <WorkingDirectory>/Error.txt oder <WorkingDirectory>/ConvPath.txt erzeugt wird.

Nach dem Ende von StartConv durchläuft ConvServSamp folgende Schritte:

Die erste Zeile der Datei <WorkingDirectory>/Error.txt wird an das SAP-System als Fehlermeldung weitergegeben, falls

die Datei <WorkingDirectory>/Error.txt existiert und

die erste Zeile dieser Datei nicht leer ist

Falls derexit codedesshell-scripts(z.B. StartConv) ungleich 0 (Null) ist, wird dieser Wert an das SAP-System als Fehler weitergegeben.

Falls keine der genannten Bedingungen zutrifft, wird der Pfadname der konvertierten Datei aus der Datei <WorkingDirectory>/ConvPath.txt gelesen. Diese Datei wird automatisch in das SAP-System transportiert und als weiteres Original abgelegt.

ConvServSamp erzeugt <WorkingDirectory>/ ConvStructFilename.txt

Vor dem Aufruf von StartConv wird von ConvServSamp die Datei <WorkingDirectory>/ConvStructFilename.txt erzeugt.

Jede Zeile dieser Datei enthält folgende Parameter:

parent_guid[38] eindeutige ID des Vaters dieses Teils

guid[38] eindeutige ID dieses Teils

file_changed[1] falls das Teil geändert wurde (z.Z. nicht unterstützt)

filename[255] Pfad name dieses Teils

Das Format ist fest. Es gibt keine Begrenzer zwischen den Einträgen.

Konverter erzeugt <WorkingDirectory> /ConvPathAndMatrix.txt

Der Konverter erzeugt anstelle der Datei <WorkingDirectory>/ConvPath.txt die Datei <WorkingDirectory>/ConvPathAndMatrix.txt. Diese Datei wird nicht gelesen, falls die Datei <WorkingDirectory>/ConvPath.txt existiert.

Jede Zeile dieser Datei enthält folgende Parameter:

parent_guid[38] eindeutige ID des Vaters dieses Teils (wie Eingabe)

guid[38] eindeutige ID dieses Teils (wie Eingabe)

filename[255] Pfadname dieses Teils Pfadname: darf keine Leerzeichen enthalten, Ende mit Leerzeichen oder Zeilenende

Für diese drei Parameter ist das Format fest. Es gibt keine Begrenzer zwischen den Einträgen.

Falls die Zeile nach dem Pfadnamen noch nicht zu Ende ist, muß sie 13 real Zahlen enthalten, zwischen denen Leerzeichen stehen müssen: locox, locoy, locoz, axis1x, axis2x, axis3x, axis1y, axis2y, axis3y, axis1z, axis2z, axis3z, scale

Mit dieser Transformationsmatrix wird die relative Position des Teils gegenüber dem Vater beschrieben.

Falls es mehrere Instanzen gibt, muß für jede Instanz eine eigene Zeile geschrieben werden. Diese Zeilen müssen bis auf die Transformationsmatrix identisch sein.