# Configuração Coringa - SQL ## Visão Geral Este módulo orienta a parametrização do Suricato Marcação para uso do driver alternativo JTDS com banco de dados SQL Server. O recurso atua como uma contingência de conectividade, sendo direcionado estritamente para cenários de incompatibilidade de sistema operacional ou de clientes de banco de dados. ## Regra de Negócio Para que a configuração alternativa de conexão com banco de dados funcione corretamente no SURICATO TOTVS Marcação, é obrigatório atender aos seguintes requisitos: * **Instalação Prévia:** O sistema SURICATO deve estar previamente instalado no ambiente. * **Presença de Módulo:** O módulo SURICATO TOTVS Marcação deve existir obrigatoriamente no diretório padrão de instalação. * **Acessibilidade do Arquivo:** O arquivo `suricato-totvs-marcacao.properties` deve estar acessível para edição no servidor. * **Parametrização de Persistência:** O arquivo `persistence.xml` deve ser configurado de forma correta. * **Restrição de SGBD:** Esta configuração é recomendada e homologada exclusivamente para o banco de dados SQL Server. * **Cenário de Aplicação:** O driver alternativo deve ser utilizado apenas quando houver incompatibilidade técnica entre sistemas operacionais ou clientes de banco de dados. * **Prioridade de Driver:** Caso não exista incompatibilidade mapeada no ambiente, deve-se utilizar obrigatoriamente a URL e o driver oficial de conexão do fabricante. * **Ciclo de Reinstalação:** Após qualquer alteração efetuada nos arquivos de configuração, o serviço deve ser reinstalado por meio da execução do arquivo de lote `install.bat`. *O não atendimento a essas regras pode comprometer o funcionamento e interromper a execução do serviço de marcação.* ## Como configurar e instalar o Serviço ### Instalação e configuração do Serviço {% stepper %} {% step %} Primeiramente, é necessário configurar o arquivo `.properties` do Suricato Marcação. * Acesse o diretório abaixo: ``` C:\Program Files\Telematica\SURICATO\SURICATO-TOTVS\SURICATOTotvsMarcacao ``` {% endstep %} {% step %} Localize o arquivo: ``` suricato-totvs-marcacao.properties ``` {% endstep %} {% step %} Abra o arquivo utilizando um editor de texto.

{% endstep %} {% endstepper %} ### Validação dos parâmetros Verifique se os parâmetros estão presentes no arquivo. Caso exista necessidade, edite os valores e salve o arquivo.

*Note – Suricato totvs marcação properties*

### Acesso ao arquivo JAR {% stepper %} {% step %} Após salvar o arquivo `.properties`, volte para o diretório: ``` C:\Program Files\Telematica\SURICATO\SURICATO-TOTVS\SURICATOTotvsMarcacao ``` {% endstep %} {% step %} Localize o arquivo: ``` SURICATO-totvs-marcacao.jar ```

{% endstep %} {% endstepper %} ### Extração do arquivo persistence.xml {% stepper %} {% step %} Abra o arquivo `SURICATO-totvs-marcacao.jar` utilizando o WinRAR e localize o arquivo: ``` persistence.xml ``` {% endstep %} {% step %} O caminho para localizar o arquivo é: ``` \META-INF ``` {% endstep %} {% step %} Clique sobre o arquivo `SURICATO-totvs-marcacao.jar` e utilize o WinRAR para extrair o arquivo.

{% endstep %} {% endstepper %} ### Configurando o Property de Conexão SURICATO {% stepper %} {% step %} Edite o arquivo `persistence.xml`. {% endstep %} {% step %} No primeiro bloco de códigos contendo a tag ``, será realizada a configuração da conexão com o banco de dados do sistema SURICATO.

{% endstep %} {% step %} Esta configuração é recomendada **somente para SQL Server** e apenas quando existir incompatibilidade entre sistemas operacionais ou clientes de banco de dados.\ Caso contrário, deve-se utilizar a URL e o driver oficial de conexão.

{% endstep %} {% endstepper %} ### Configurando o Property de Conexão TOTVS {% stepper %} {% step %} No segundo bloco de códigos contendo a tag ``, será realizada a configuração da conexão com o banco de dados do sistema TOTVS.

*Configurando – Property de Conexão TOTVS*

{% endstep %} {% step %} Após concluir as configurações do arquivo `persistence.xml`, salve o arquivo e substitua o original dentro do `SURICATO-totvs-marcacao.jar`. {% endstep %} {% step %} Em seguida, execute a **bat install** para que o serviço de marcação seja instalado corretamente.

{% endstep %} {% endstepper %} ## FAQ – Perguntas Frequentes

Quando devo utilizar a configuração coringa de conexão com banco de dados?

Essa configuração deve ser utilizada somente para SQL Server e apenas quando houver incompatibilidade entre sistemas operacionais ou clientes de banco de dados.

Posso utilizar essa configuração para outros bancos além do SQL Server?

Não. O uso é recomendado exclusivamente para SQL Server.

Se não houver incompatibilidade, qual configuração devo utilizar?

Deve-se utilizar a URL e o driver oficial de conexão com o banco de dados.

Após alterar o persistence.xml, o serviço não funcionou. O que pode ter ocorrido?

Verifique se o arquivo foi corretamente substituído dentro do `SURICATO-totvs-marcacao.jar` e se a `bat install` foi executada após a alteração.

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-de-servicos-do-suricato/instalacao-e-configuracao-do-coletor-de-marcacao/configuracao-coringa-sql.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.