Przewodnik instalacji interfejsu API Web CAD » Darmowy program DWG Viewer online | GstarCAD Viewer

Spis treści

1. Wymagania systemowe

Windows 7 lub Windows Server2008 i nowsze 64-bitowe
JDK1.8

2. Instalacja programu licencyjnego

Zainstaluj pakiet oprogramowania w folderze „Licensing Control System”.
Otwórz „Narzędzie użytkownika Virbox”, kliknij Utwórz plik c2d powiązany z trybem offline i wyślij plik do firmy Gstarsoft.

Gstarsoft wygeneruje pliki licencyjne na podstawie pliku c2d. Kliknij opcję Importuj plik d2c powiązany z trybem offline, wybierz plik pakietu i kliknij przycisk Aktualizuj, aby aktywować licencję.

3. Uruchom program do planowania zadań

Otwórz apache-zookeeper-3.7.1/conf/zoo.cfg i zmień lokalizację dziennika.

Otwórz plik apache-zookeeper-3.7.1/bin/zkServer.cmd i nie zamykaj interfejsu wiersza poleceń.
Najpierw należy uruchomić aplikację Zookeeper, dlatego przed uruchomieniem uruchom WebCADDWGTransfer.exe jako administrator i sprawdź, czy usługa została uruchomiona. Jeśli tak, kliknij przycisk Zatrzymaj, a następnie poczekaj na uruchomienie aplikacji Zookeeper i uruchom usługę konwersji.

4. Uruchom usługę portu API

Utwórz folder będący katalogiem głównym do zapisywania plików rysunków, np. D:\WebCADAPI\files, a następnie otwórz folder, aby utworzyć dwa dodatkowe foldery, mianowicie cad i Swap.

Zapamiętaj ścieżkę folderu cad i folderu Swap, których użyjemy później. Folder pliku cad jest używany do zapisywania rysunków i plików po konwersji, podczas gdy folder pliku Swap jest przestrzenią wymiany dla programu konwertującego.

Otwórz plik konfiguracyjny gtfs-win64-en\application.properties, jeśli nie znajduje się on w domyślnej ścieżce D:/WebCADAPI/files/cad, zmień go i zwróć uwagę na kierunek symboli ukośnika.

Następnie kliknij dwukrotnie start.bat, aby uruchomić usługę lub uruchom wiersz poleceń w bieżącym katalogu, wprowadź java -Xmx1024m -Xms1024m -Xss256k -javaagent:sjt_agent.jar -jar GstarTransformServer-1.0.0.jar, aby uruchomić usługę. Nie zamykaj interfejsu wiersza poleceń.

5. Uruchom program konfiguracji i konwersji

Kliknij prawym przyciskiem myszy WebCADDWGTransfer-en/WebCADManager.exe i wybierz opcję Uruchom jako administrator, aby otworzyć.
W programie znajduje się wiele ustawień konfiguracyjnych, nie należy zmieniać parametrów innych niż te wymienione poniżej, dopuszczalne jest użycie wartości domyślnych.

1. Zadanie Klienta

Wybierz Zookeeper, dodaj 127.0.0.1:2181 do konfiguracji, nie zmieniaj innych parametrów.

2. Ustawienia katalogu, zwróć uwagę na kierunek symbolu ukośnika

Dane, pamięć podręczna, temp.: wprowadź katalog główny dla wszystkich trzech D:\WebCADAPI\files\cad
Przestrzeń wymiany: D:\WebCADAPI\files\Swap
Czcionka, przestrzeń czcionki: folder czcionek w bieżącym katalogu D:\WebCADAPI\WebCADDWGTransfer\font

3. Konwerter danych rysunkowych

Kliknij przycisk na końcu procesu i wybierz plik WebCADDWGTransfer.exe w katalogu plików.
Kliknij przycisk Zastosuj w prawym dolnym rogu, następnie kliknij przycisk „Zainstaluj” i kliknij przycisk „Start”.
Przed modyfikacją dowolnego parametru kliknij przycisk Zatrzymaj.
Jeśli oprogramowanie musi zostać przeniesione do innego katalogu, zatrzymaj je i odinstaluj, a następnie skonfiguruj ustawienia w nowym katalogu, aby zainstalować i uruchomić oprogramowanie.

Maksymalna liczba jest zazwyczaj ustawiana zgodnie z liczbą rdzeni procesora, na przykład w przypadku procesora 4-rdzeniowego wartość można ustawić na 4 dla wszystkich trzech. Pamięć to kolejna kwestia do rozważenia, każda liczba wymaga co najmniej 3G pamięci, więc aby ustawić wartość na 4, potrzeba co najmniej 12G pamięci.

Parametry, które nie zostały wymienione, nie wymagają modyfikacji, wystarczy pozostawić je domyślne.

6. Harmonogramowanie portów API konwersji

Otwórz za pomocą przeglądarki: http://localhost:7088/docs.html wyświetlane są powiązane funkcje portu.
Weźmy na przykład funkcję konwersji ocf, wyślij żądanie http post do tego portu, używając następujących parametrów. Istnieją strumienie plików i adresy URL obsługiwane dla plików CAD, po prostu wybierz jeden z nich.

Kliknij Debuguj, aby bezpośrednio wysłać żądanie tekstowe za pomocą interfejsu, wybierz plik lub wprowadź adres pobierania rysunku CAD, a następnie kliknij przycisk Prześlij, aby zwrócić wynik. Znajduje się tam identyfikator zadania, którego można użyć do sprawdzenia wyników.

Kliknij i sprawdź wyniki wykonania zadania, wprowadź identyfikator zadania, aby uzyskać wyniki konwersji. Następnie pobierz ocf na serwer plików za pomocą adresu pobierania ocf url.

{
"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"
]
}
}

kod rtnCode

Wartość	Opis
0000000	Udany
0000001	Funkcja nie jest autoryzowana, skontaktuj się z administratorem
0000002	Serwer zajęty, spróbuj ponownie później
0000003	Parametry nieprawidłowe
0000004	Nazwa pliku nie może być pusta
0000005	Plik nie znaleziony
0000006	Zadanie konwersji nie istnieje
0000007	Proszę przesłać plik dwg
0000008	Proszę przesłać plik ocf
0000009	Proszę przesłać plik z rysunkiem 3D
0000010	Proszę przesłać plik ocf3
0000011	Proszę przesłać plik dwg/ocf
0000012	Proszę przesłać plik rvt/stl/ifc/ocf3
0000013	Zapisz jako inne typy plików: obsługiwane tylko w formatach dwg/dxf
0000014	zapisz jako inne wersje: 0^ ~5
0000015	Proszę przesłać plik pdf
0000018	Nieprawidłowa domena adresu URL pliku. Sprawdź i spróbuj ponownie.
0000019	Wystąpił błąd podczas pobierania pliku URL. Sprawdź adres URL i spróbuj ponownie.
0000020	Wystąpił błąd podczas odbierania strumienia plików. Sprawdź i spróbuj ponownie

Status w bizData pokazuje stan konwersji rysunków:

0 : Nie rozpoczęto
1 : W trakcie
2: Zakończenie konwersji oznacza jedynie, że program konwersji zaplecza zwrócił wyniki, nie oznacza to, że plik ocf został wygenerowany, konwersja mogła się nie powieść i nie został wygenerowany żaden plik ocf.
resultCode jest taki sam jak kod w starszych wersjach parametrów zwracanych przez Linuksa, z tym wyjątkiem, że 0 oznacza, że ocf został wygenerowany, a wszystkie inne przypadki oznaczają, że wygenerowanie ocf się nie powiodło.

Kod	Opis
0		Udana konwersja, w przeciwnym razie nieudana
2		Błędny klasa zadania parametr
404		Nie znaleziono odpowiedniego rysunku
800		Nieudane konwersje wynikają głównie z plików rysunkowych, a do znalezienia przyczyny niepowodzenia potrzebne są oddzielne pliki rysunkowe.
801		Nieprawidłowy parametr wejściowy
802		Nieprawidłowy plik konfiguracyjny

Obecna wersja obsługuje jedynie konwersję rysunków 2D w formatach dwg i dxf. Konwersja rysunków 3D jest wciąż w fazie rozwoju i jej zakończenie jest planowane na drugą połowę roku, więc można bezpiecznie zignorować kwestię konwersji do formatu 3D.