Guide d'installation de l'API Web CAD

1. Configuration requise

Windows 7 ou Windows Server 2008 et supérieur 64 bits
JDK 1.8

2. Installation du programme de licence

Installez le progiciel sous le dossier « Licensing Control System ».
Ouvrez « Virbox User Tool », cliquez sur Créer un fichier c2d lié hors ligne et envoyez le fichier à la société Gstarsoft.

Gstarsoft générera des fichiers de licence basés sur le fichier c2d, cliquez sur Importer un fichier d2c hors ligne, choisissez le fichier de package et cliquez sur le bouton Mettre à jour pour activer la licence.

3.Démarrez le programme de planification des tâches

Ouvrez apache-zookeeper-3.7.1/conf/zoo.cfg, modifiez l'emplacement du journal.

Ouvrez apache-zookeeper-3.7.1/bin/zkServer.cmd et ne fermez pas l'interface de ligne de commande.
zookeeper doit d'abord être démarré, donc avant de démarrer, exécutez WebCADDWGTransfer.exe en tant qu'administrateur et voyez si le service est démarré, cliquez sur le bouton Arrêter s'il est démarré, attendez que zookeeper démarre, puis démarrez le service de conversion.

4. démarrer le service de port API

Créez un dossier comme répertoire racine pour enregistrer les fichiers de dessin, tels que D:\WebCADAPI\files, puis ouvrez le dossier pour créer deux autres dossiers, à savoir cad et Swap.

Rappelez-vous le chemin du dossier cad et du dossier Swap, que nous utiliserons plus tard. Le dossier de fichiers cad est utilisé pour enregistrer les dessins et les fichiers après la conversion tandis que le dossier de fichiers Swap est l'espace d'échange pour le programme de conversion.

Ouvrez le fichier de configuration gtfs-win64-en\application.properties, s'il ne se trouve pas dans le chemin par défaut de D:/WebCADAPI/files/cad, modifiez-le et faites attention à la direction des symboles de barre oblique.

Double-cliquez ensuite sur start.bat pour démarrer le service ou démarrez la ligne de commande dans le répertoire actuel, saisissez java -Xmx1024m -Xms1024m -Xss256k -javaagent:sjt_agent.jar -jar GstarTransformServer-1.0.0.jar pour démarrer le service. Veuillez ne pas fermer l'interface de ligne de commande.

5.Démarrer le programme de configuration et de conversion

Cliquez avec le bouton droit sur WebCADDWGTransfer-en/WebCADManager.exe, puis sélectionnez Exécuter en tant qu’administrateur pour ouvrir.
Il existe de nombreux paramètres de configuration dans le programme, ne modifiez pas les paramètres autres que ceux mentionnés ci-dessous, l'utilisation des valeurs par défaut est OK.

1. Client de tâches

Sélectionnez Zookeeper, ajoutez 127.0.0.1:2181 à la configuration, veuillez ne pas modifier les autres paramètres.

2. Paramètres du répertoire, faites attention au sens du symbole de barre oblique

Données, Cache, Temp : saisissez le répertoire racine pour les trois fichiers D:\WebCADAPI\files\cad
Espace d'échange : D:\WebCADAPI\files\Swap
Police, Espace police : dossier de polices dans le répertoire actuel D:\WebCADAPI\WebCADDWGTransfer\font

3.Convertisseur de données de dessin

Cliquez sur le bouton à la fin du processus et sélectionnez WebCADDWGTransfer.exe dans le répertoire de fichiers.
Cliquez sur le bouton Appliquer dans le coin inférieur droit, puis sur le bouton « Installer » et sur le bouton « Démarrer ».
Veuillez cliquer sur Arrêter avant de modifier un paramètre.
Si le logiciel doit être déplacé vers un autre répertoire, arrêtez-le et désinstallez-le, puis configurez les paramètres dans le nouveau répertoire pour installer et démarrer le logiciel.

Le nombre maximal est généralement défini en fonction du nombre de cœurs du processeur. Par exemple, avec un processeur à 4 cœurs, la valeur peut être définie sur 4 pour les trois. La mémoire est un autre élément à prendre en compte, chaque nombre nécessite au moins 3 Go de mémoire. Pour définir la valeur sur 4, il faut donc au moins 12 Go de mémoire.

Les paramètres qui ne sont pas mentionnés n'ont pas besoin d'être modifiés, laissez-les simplement par défaut.

6. Planification des ports de l'API de conversion

Visitez avec le navigateur : http://localhost:7088/docs.html les fonctions du port associées sont affichées.
Prenons comme exemple la fonction de conversion ocf, envoyez une requête http post à ce port en utilisant les paramètres suivants. Il existe des flux de fichiers et des URL pris en charge pour les fichiers CAO, il suffit de choisir l'un ou l'autre.

Cliquez sur Déboguer pour envoyer directement une demande de texte à l'aide de l'interface, choisissez un fichier ou entrez l'adresse de téléchargement du dessin CAO, puis cliquez sur le bouton Soumettre pour renvoyer le résultat. Il existe un ID de tâche qui peut être utilisé pour vérifier les résultats.

Cliquez et vérifiez les résultats de l'exécution de la tâche, saisissez l'ID de la tâche pour obtenir les résultats de la conversion. Téléchargez ensuite ocf sur le serveur de fichiers à l'aide de l'adresse URL de téléchargement ocf.

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

code rtnCode

 

Valeur

Description

0000000

Réussi

0000001

La fonction n'est pas autorisée, veuillez contacter l'administrateur

0000002

Serveur occupé, veuillez réessayer plus tard

0000003

Paramètres anormaux

0000004

Le nom de fichier ne peut pas être vide

0000005

Fichier introuvable

0000006

La tâche de conversion n'existe pas

0000007

Veuillez télécharger le fichier dwg

0000008

Veuillez télécharger le fichier ocf

0000009

Veuillez télécharger le fichier de dessin 3D

0000010

Veuillez télécharger le fichier ocf3

0000011

Veuillez télécharger le fichier dwg/ocf

0000012

Veuillez télécharger le fichier rvt/stl/ifc/ocf3

0000013

Enregistrer sous d'autres types de fichiers : pris en charge uniquement dans dwg/dxf

0000014

enregistrer sous d'autres versions : 0^ ~5

0000015

Veuillez télécharger le fichier PDF

0000018

Mauvais domaine de l'URL du fichier, veuillez vérifier et réessayer

0000019

Une erreur s'est produite lors du téléchargement du fichier URL, veuillez vérifier l'URL et réessayer.

0000020

Une erreur s'est produite lors de la réception du flux de fichiers, veuillez vérifier et réessayer

 

Le statut dans bizData indique le statut de la conversion du dessin :

0 : Pas commencé
1 : En cours
2 : La conversion terminée signifie uniquement que le programme de conversion back-end a renvoyé les résultats, cela ne signifie pas que l'ocf a été généré, la conversion peut avoir échoué et aucun ocf n'a été généré.
resultCode est le même que le code des paramètres de retour de l'ancienne version Linux, sauf que 0 signifie que l'ocf est généré et tous les autres cas signifient que la génération de l'ocf a échoué.

 

Code

Description

0

Conversion réussie, sinon échec

2

Incorrect classe de tâches paramètre

404

Dessin correspondant non trouvé

800

Les conversions infructueuses sont principalement dues aux fichiers de dessin, et des fichiers de dessin individuels sont nécessaires pour trouver la cause de l'échec.

801

Paramètre d'entrée incorrect

802

Fichier de configuration incorrect

La version actuelle ne prend en charge que la conversion de dessins 2D aux formats dwg et dxf. La conversion de dessins 3D est toujours en cours de développement et devrait être terminée au cours du second semestre de l'année. Le port lié à la 3D peut donc être ignoré en toute sécurité.