Installationshandbuch für die Web-CAD-API

1.Systemanforderungen

Windows 7 oder Windows Server 2008 und höher 64 Bit
JDK1.8

2.Installation des Lizenzprogramms

Installieren Sie das Softwarepaket im Ordner „Licensing Control System“.
Öffnen Sie das „Virbox User Tool“, klicken Sie auf „Offline-gebundene c2d-Datei erstellen“ und senden Sie die Datei an die Firma Gstarsoft.

Gstarsoft generiert Lizenzdateien basierend auf der c2d-Datei. Klicken Sie auf „Offline-gebundene d2c-Datei importieren“, wählen Sie die Paketdatei aus und klicken Sie auf die Schaltfläche „Aktualisieren“, um die Lizenz zu aktivieren.

3.Starten Sie das Taskplanungsprogramm

Öffnen Sie apache-zookeeper-3.7.1/conf/zoo.cfg und ändern Sie den Protokollspeicherort.

Öffnen Sie apache-zookeeper-3.7.1/bin/zkServer.cmd und schließen Sie die Befehlszeilenschnittstelle nicht.
Zookeeper muss zuerst gestartet werden. Führen Sie daher vor dem Start WebCADDWGTransfer.exe als Administrator aus und prüfen Sie, ob der Dienst gestartet ist. Klicken Sie auf die Schaltfläche „Stopp“, wenn er gestartet ist, und warten Sie, bis Zookeeper gestartet ist. Starten Sie dann den Konvertierungsdienst.

4. Starten Sie den API-Port-Dienst

Erstellen Sie einen Ordner als Stammverzeichnis zum Speichern von Zeichnungsdateien, z. B. D:\WebCADAPI\files, und öffnen Sie dann den Ordner, um zwei weitere Ordner zu erstellen, nämlich „cad“ und „Swap“.

Merken Sie sich den Pfad des Ordners „cad“ und des Ordners „Swap“, die wir später verwenden werden. Der Ordner „cad“ wird zum Speichern von Zeichnungen und Dateien nach der Konvertierung verwendet, während der Ordner „Swap“ der Auslagerungsspeicher für das Konvertierungsprogramm ist.

Öffnen Sie die Konfigurationsdatei gtfs-win64-en\application.properties, wenn sie sich nicht im Standardpfad D:/WebCADAPI/files/cad befindet, ändern Sie sie und Achten Sie auf die Richtung der Schrägstriche.

Doppelklicken Sie dann auf start.bat, um den Dienst zu starten, oder starten Sie die Befehlszeile im aktuellen Verzeichnis und geben Sie java -Xmx1024m -Xms1024m -Xss256k -javaagent:sjt_agent.jar -jar GstarTransformServer-1.0.0.jar ein, um den Dienst zu starten. Bitte schließen Sie die Befehlszeilenschnittstelle nicht.

5.Konfigurations- und Konvertierungsprogramm starten

Klicken Sie mit der rechten Maustaste auf WebCADDWGTransfer-en/WebCADManager.exe und wählen Sie dann zum Öffnen „Als Administrator ausführen“ aus.
Das Programm enthält zahlreiche Konfigurationseinstellungen. Ändern Sie keine anderen Parameter als die unten aufgeführten. Die Verwendung der Standardwerte ist in Ordnung.

1.Aufgaben-Client

Wählen Sie Zookeeper, fügen Sie 127.0.0.1:2181 zur Konfiguration hinzu, ändern Sie bitte keine anderen Parameter.

2. Verzeichniseinstellungen, achten Sie auf die Richtung des Schrägstrichs

Daten, Cache, Temp: Geben Sie das Stammverzeichnis für alle drei ein: D:\WebCADAPI\files\cad
Auslagerungsbereich: D:\WebCADAPI\files\Swap
Schriftart, Schriftartbereich: Schriftartordner im aktuellen Verzeichnis D:\WebCADAPI\WebCADDWGTransfer\font

3.Zeichnungsdatenkonverter

Klicken Sie am Ende des Vorgangs auf die Schaltfläche und wählen Sie WebCADDWGTransfer.exe im Dateiverzeichnis aus.
Klicken Sie unten rechts auf die Schaltfläche „Übernehmen“, dann auf die Schaltfläche „Installieren“ und schließlich auf die Schaltfläche „Start“.
Klicken Sie bitte auf „Stopp“, bevor Sie einen Parameter ändern.
Wenn die Software in ein anderes Verzeichnis verschoben werden muss, stoppen und deinstallieren Sie sie bitte und konfigurieren Sie dann die Einstellungen im neuen Verzeichnis, um die Software zu installieren und zu starten.

Die maximale Anzahl wird im Allgemeinen entsprechend der Anzahl der Kerne der CPU festgelegt. Bei einer 4-Kern-CPU kann der Wert beispielsweise für alle drei auf 4 festgelegt werden. Der Speicher ist ein weiterer zu berücksichtigender Aspekt. Jede Anzahl benötigt mindestens 3 GB Speicher. Um den Wert auf 4 festzulegen, sind also mindestens 12 GB Speicher erforderlich.

Nicht erwähnte Parameter müssen nicht geändert werden. Belassen Sie sie einfach auf der Standardeinstellung.

6.Konvertierungs-API-Portplanung

Besuchen Sie mit dem Browser: http://localhost:7088/docs.html. Zugehörige Portfunktionen werden angezeigt.
Nehmen Sie die OCF-Konvertierungsfunktion als Beispiel und senden Sie eine HTTP-Post-Anfrage mit den folgenden Parametern an diesen Port. Für CAD-Dateien werden Dateistream und URL unterstützt. Wählen Sie einfach eines davon aus.

Klicken Sie auf „Debuggen“, um über die Schnittstelle direkt eine Textanforderung zu senden, wählen Sie eine Datei aus oder geben Sie die Download-Adresse für die CAD-Zeichnung ein und klicken Sie auf die Schaltfläche „Senden“, um das Ergebnis zurückzugeben. Es gibt eine Aufgaben-ID, mit der die Ergebnisse überprüft werden können.

Klicken Sie und überprüfen Sie die Ergebnisse der Aufgabenausführung. Geben Sie die Aufgaben-ID ein, um die Konvertierungsergebnisse zu erhalten. Laden Sie dann OCF mithilfe der OCF-URL-Downloadadresse auf den Dateiserver herunter.

{
"rtnCode": "0000000",
"msg": "success",
"ts": 1679977119909,
"bizData": {
"taskType": "MAKEOCF",
"requestId": "f52d3778-9931-45a6-b4d8-614bdb385f92",
"status": 2,
"resultCode": 0,
"resultMsg": "OK",
"transformStartTime": "2023-03-28 12:02:48",
"transformEndTime": "2023-03-28 12:02:48",
"extData": "123sdfsdfsdfgsdsdfsd",
"localPath": "D:/WebCADAPI/files/cad/ocf/2023/03/28/0000000001.1.ocf",
"ocfUrl": "http://localhost:7088/openapi/v1/download?fileId=55223d90-b990-4d3f-b40b-4ecd0f4ee184",
"ocfName": "0000000001.1.ocf",
"version": "1.07",
"layout": "*Model_Space",
"layouts": [
"31",
"*Model_Space",
"Model",
"88",
"*Paper_Space",
"Layout1",
"93",
"*Paper_Space0",
"2222"
]
}
}

rtnCode-Code

 

Wert	Beschreibung
0000000	Erfolgreich
0000001	Die Funktion ist nicht autorisiert. Bitte wenden Sie sich an den Administrator.
0000002	Server beschäftigt, bitte versuchen Sie es später noch einmal
0000003	Abnormale Parameter
0000004	Der Dateiname darf nicht leer sein
0000005	Datei nicht gefunden
0000006	Konvertierungsaufgabe existiert nicht
0000007	Bitte laden Sie die DWG-Datei hoch.
0000008	Bitte laden Sie die OCF-Datei hoch.
0000009	Bitte laden Sie die 3D-Zeichnungsdatei hoch
0000010	Bitte laden Sie die OCF3-Datei hoch.
0000011	Bitte laden Sie die DWG/OCF-Datei hoch.
0000012	Bitte laden Sie die RVT/STL/IFC/OCF3-Datei hoch.
0000013	Speichern als andere Dateitypen: nur in dwg/dxf unterstützt
0000014	unter anderen Versionen speichern: 0^ ~5
0000015	Bitte laden Sie die PDF-Datei hoch
0000018	Falsche Domäne der Datei-URL. Bitte überprüfen Sie und versuchen Sie es erneut.
0000019	Beim Herunterladen der URL-Datei ist ein Fehler aufgetreten. Bitte überprüfen Sie die URL und versuchen Sie es erneut.
0000020	Beim Empfangen des Dateistreams ist ein Fehler aufgetreten. Bitte überprüfen Sie und versuchen Sie es erneut.

 

Der Status in bizData zeigt den Stand der Zeichnungskonvertierung an:

0: Nicht gestartet
1 : In Bearbeitung
2: Eine abgeschlossene Konvertierung bedeutet nur, dass das Back-End-Konvertierungsprogramm die Ergebnisse zurückgegeben hat. Es bedeutet nicht, dass die OCF generiert wurde. Möglicherweise ist die Konvertierung fehlgeschlagen und es wurde keine OCF generiert.
Der resultCode ist derselbe wie der Code in den Rückgabeparametern alter Linux-Versionen, außer dass 0 bedeutet, dass OCF generiert wurde, und in allen anderen Fällen bedeutet, dass die Generierung von OCF fehlgeschlagen ist.

 

Code	Beschreibung
0		Erfolgreiche Konvertierung, andernfalls erfolglos
2		Falsch Aufgabenklasse Parameter
404		Entsprechende Zeichnung nicht gefunden
800		Bei fehlgeschlagenen Konvertierungen liegt es meist an den Zeichnungsdateien und es werden einzelne Zeichnungsdateien benötigt, um die Ursache für den Fehler zu finden.
801		Falscher Eingabeparameter
802		Falsche Konfigurationsdatei

Die aktuelle Version unterstützt nur die Konvertierung von 2D-Zeichnungen in den Formaten DWG und DXF. Die Konvertierung von 3D-Zeichnungen befindet sich noch in der Entwicklung und wird voraussichtlich in der zweiten Jahreshälfte abgeschlossen sein. Der 3D-bezogene Port kann daher getrost ignoriert werden.