Guia de instalação da API Web CAD

1. Requisitos do sistema

Windows 7 ou Windows server 2008 e superior de 64 bits
JDK1.8

2. Instalação do programa de licenciamento

Instale o pacote de software na pasta “Sistema de Controle de Licenciamento”.
Abra a “Ferramenta do usuário Virbox”, clique em Criar arquivo c2d vinculado offline e envie o arquivo para a empresa Gstarsoft.

O Gstarsoft gerará arquivos de licenciamento com base no arquivo c2d, clique em Importar arquivo d2c vinculado offline, escolha o arquivo do pacote e clique no botão Atualizar para ativar a licença.

3. Inicie o programa de agendamento de tarefas

Abra apache-zookeeper-3.7.1/conf/zoo.cfg e altere o local do log.

Abra apache-zookeeper-3.7.1/bin/zkServer.cmd e não feche a interface de linha de comando.
O zookeeper deve ser iniciado primeiro, então, antes de iniciar, execute WebCADDWGTransfer.exe como administrador e veja se o serviço foi iniciado, clique no botão Parar se estiver iniciado e aguarde o zookeeper iniciar e então inicie o serviço de conversão.

4.iniciar serviço de porta API

Crie uma pasta como diretório raiz para salvar arquivos de desenho, como D:\WebCADAPI\files, depois abra a pasta para criar mais duas pastas, cad e Swap.

Lembre-se do caminho da pasta cad e da pasta Swap, que usaremos mais tarde. A pasta de arquivo cad é usada para salvar desenhos e arquivos após a conversão, enquanto a pasta de arquivo Swap é o espaço de swap para o programa de conversão.

Abra o arquivo de configuração gtfs-win64-en\application.properties, se não estiver no caminho padrão D:/WebCADAPI/files/cad, altere-o e preste atenção na direção dos símbolos de barra.

Em seguida, clique duas vezes em start.bat para iniciar o serviço ou inicie a linha de comando no diretório atual, insira java -Xmx1024m -Xms1024m -Xss256k -javaagent:sjt_agent.jar -jar GstarTransformServer-1.0.0.jar para iniciar o serviço. Não feche a interface da linha de comando.

5. Inicie o programa de configuração e conversão

Clique com o botão direito do mouse em WebCADDWGTransfer-en/WebCADManager.exe e selecione Executar como administrador para abrir.
Há muitas configurações no programa, não altere parâmetros além dos mencionados abaixo, usar valores padrão é aceitável.

1. Tarefa Cliente

Selecione Zookeeper, adicione 127.0.0.1:2181 à configuração, não altere outros parâmetros.

2. Configurações de diretório, preste atenção à direção do símbolo de barra

Dados, Cache, Temp: insira o diretório raiz para todos os três D:\WebCADAPI\files\cad
Espaço de troca: D:\WebCADAPI\files\Swap
Fonte, Espaço da fonte: pasta de fontes no diretório atual D:\WebCADAPI\WebCADDWGTransfer\font

3. Conversor de dados de desenho

Clique no botão no final do Processo e selecione WebCADDWGTransfer.exe no diretório do arquivo.
Clique no botão Aplicar no canto inferior direito, depois clique no botão “Instalar” e clique no botão “Iniciar”.
Clique em Parar antes de modificar qualquer parâmetro.
Se o software precisar ser movido para outro diretório, pare e desinstale-o, depois configure as configurações no novo diretório para instalar e iniciar o software.

A contagem máxima é geralmente definida de acordo com o número de núcleos que a CPU tem, por exemplo, com CPU de 4 núcleos, o valor pode ser definido como 4 para todos os três. Memória é outra coisa a considerar, cada contagem precisa de pelo menos 3G de memória, então para definir o valor como 4, pelo menos 12G de memória são necessários.

Parâmetros não mencionados não precisam de modificação, basta deixá-los como padrão.

6. Agendamento de porta da API de conversão

Visite com o navegador: http://localhost:7088/docs.html as funções de porta relacionadas são exibidas.
Tome a função de conversão ocf como exemplo, envie solicitação http post para esta porta usando os seguintes parâmetros. Há fluxo de arquivo e url suportados para arquivos CAD, basta escolher um deles.

Clique em Depurar para enviar diretamente a solicitação de texto usando a interface, escolha o arquivo ou insira o endereço de download do desenho CAD e clique no botão Enviar para retornar o resultado. Há um ID de tarefa que pode ser usado para verificar os resultados.

Clique e verifique os resultados da execução da tarefa, insira o ID da tarefa para obter os resultados da conversão. Em seguida, baixe o ocf para o servidor de arquivos usando o endereço de download da url do 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"
]
}
}

código rtnCode

 

Valor

Descrição

0000000

Bem-sucedido

0000001

A função não está autorizada, entre em contato com o administrador

0000002

Servidor ocupado, tente novamente mais tarde

0000003

Parâmetros anormais

0000004

O nome do arquivo não pode estar vazio

0000005

Arquivo não encontrado

0000006

A tarefa de conversão não existe

0000007

Por favor, carregue o arquivo dwg

0000008

Por favor, carregue o arquivo ocf

0000009

Por favor, carregue o arquivo de desenho 3D

0000010

Por favor, carregue o arquivo ocf3

0000011

Por favor, carregue o arquivo dwg/ocf

0000012

Por favor carregue o arquivo rvt/stl/ifc/ocf3

0000013

Salvar como outros tipos de arquivo: suportado apenas em dwg/dxf

0000014

salvar como outras versões: 0^ ~5

0000015

Por favor, carregue o arquivo pdf

0000018

Domínio errado da URL do arquivo, verifique e tente novamente

0000019

Ocorreu um erro durante o download do arquivo url. Verifique a url e tente novamente.

0000020

Ocorreu um erro durante o recebimento do fluxo de arquivos. Verifique e tente novamente.

 

O status no bizData mostra o status da conversão do desenho:

0 : Não iniciado
1 : Em processo
2: A conversão concluída significa apenas que o programa de conversão de back-end retornou os resultados, não significa que o ocf foi gerado, a conversão pode ter falhado e nenhum ocf foi gerado.
resultCode é o mesmo que o código nos parâmetros de retorno da versão antiga do Linux, exceto que 0 significa que ocf foi gerado e todos os outros casos significam falha na geração de ocf.

 

Código

Descrição

0

Conversão bem-sucedida, caso contrário, sem sucesso

2

Incorreto classe de tarefa parâmetro

404

Desenho correspondente não encontrado

800

Conversões malsucedidas ocorrem principalmente devido aos arquivos de desenho, e arquivos de desenho individuais são necessários para encontrar a causa da falha.

801

Parâmetro de entrada incorreto

802

Arquivo de configuração incorreto

A versão atual suporta apenas conversão de desenhos 2D nos formatos dwg e dxf. A conversão de desenhos 3D ainda está em desenvolvimento e deve ser concluída no segundo semestre do ano. Portanto, a porta relacionada a 3D pode ser ignorada com segurança.