# Testando o SuriPlayer

## Visão Geral

O teste do **SuriPlayer** tem como objetivo confirmar se o **SuriPlayerService** está sendo iniciado corretamente no Windows após a configuração do banco de dados.

## Regra de Negócio

* **Disponibilidade do SGBD:** O banco de dados SQL Server deve estar previamente ativo e com conexões remotas permitidas na rede.
* **Arquitetura da Ferramenta:** É obrigatória a utilização do utilitário Administrador de Fonte de Dados ODBC (32 bits) para o registro da conexão.
* **Homologação do Driver:** O driver de comunicação selecionado para a fonte de dados deve ser obrigatoriamente o ODBC Driver for SQL Server.
* **Identificação da Fonte:** A Fonte de Dados de Sistema (System DSN) deve ser criada obrigatoriamente com a nomenclatura exata: `Suriplayers_odbc`.
* **Modo de Autenticação:** A validação de credenciais deve ser realizada utilizando o modo de autenticação padrão do SQL Server (usuário e senha do banco).
* **Parâmetros da Aplicação:** O arquivo `suriplayers.properties` deve estar parametrizado em conformidade com as chaves de conexão criadas no Windows.
* **Nível de Acesso:** O operador deve possuir privilégios administrativos no sistema operacional para criar registros de ODBC e modificar arquivos de configuração no diretório local.

*O não atendimento a esses requisitos impedirá a conexão do Suricato Player com o banco de dados.*

## Como testar o SuriPlayer

Após configurar o banco de dados, siga os passos abaixo para testar o funcionamento do SuriPlayer.

**Iniciando o serviço pelo Windows Services**

{% stepper %}
{% step %}
Pressione as teclas **Windows + R** no teclado. Na janela **Executar**, digite:  `services.msc`  e clique no botão **OK**.

<div align="center"><figure><img src="/files/sQ6pkk90zMTMBoO8FNs1" alt=""><figcaption><p><em>Exemplo - Executar do Windows</em></p></figcaption></figure></div>
{% endstep %}

{% step %}
A janela **Services** será aberta. Nela, localize o serviço:

```
Suricato Player
```

<figure><img src="/files/de94OgJjTtAqS4aJHi1W" alt=""><figcaption><p><em>Exemplo - Serviços</em></p></figcaption></figure>
{% endstep %}

{% step %}
Clique com o botão direito do mouse sobre o serviço Suricato Player, e selecione a opção **Iniciar** e aguarde o serviço iniciar.

<figure><img src="/files/I1TSwCoDOaZgjfBFKuss" alt=""><figcaption><p><em>Exemplo - Iniciar Suricato Player</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
**Atenção:** Verifique se o arquivo **OCX** não foi removido ou transferido para a quarentena pelo antivírus.
{% endhint %}

#### Verificando o serviço no Event Viewer

{% stepper %}
{% step %}
Pressione novamente as teclas **Windows + R**. Na janela **Executar**, digite: `eventvwr.msc`

<figure><img src="/files/sU43Z8xv6OmNIR9KEKrc" alt=""><figcaption><p><em>Exemplo - Executar do Windows</em></p></figcaption></figure>
{% endstep %}

{% step %}
Ao abrir o **Event Viewer (Visualizador de Eventos)**, no menu da esquerda selecione:

* **Logs de Aplicativos e Serviços**
* **Suricato**

<figure><img src="/files/x8LqRh9KkijVDZGVLeAV" alt=""><figcaption><p><em>Exemplo - Visualizador de Eventos</em></p></figcaption></figure>
{% endstep %}

{% step %}
Na lista central, localize o evento correspondente à **data e hora da execução do serviço**.
{% endstep %}

{% step %}
Verifique na coluna **Fonte** o nome:

```
Suricato Players Controller
```

{% endstep %}

{% step %}
Clique uma vez sobre o evento. Na parte inferior, na aba **Geral**, será exibida a mensagem retornada pelo serviço.

```
*** INICIADO O SERVIÇO - Suricato Player - ( SuriPlayerService ) ***
```

O serviço foi iniciado corretamente.

<figure><img src="/files/v4JL67PR2CamRSwfhyRR" alt=""><figcaption><p><em>Exemplo - Visualizador de Eventos</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Glossário

* **Windows Services (services.msc)**: Gerenciador de serviços do Windows onde é possível iniciar, parar e monitorar serviços.
* **Event Viewer (eventvwr.msc)**: Ferramenta do Windows utilizada para visualizar logs e eventos do sistema.
* **OCX**: Componente ActiveX necessário para o funcionamento correto do SuriPlayer.
* **Suricato Players Controller**: Fonte do evento registrada no Visualizador de Eventos referente ao SuriPlayer.

## FAQ – Perguntas Frequentes

<details>

<summary><strong>O serviço Suricato Player não inicia. O que verificar primeiro?</strong></summary>

Confirme se o banco de dados está configurado corretamente e se o serviço foi instalado com sucesso.

</details>

<details>

<summary><strong>Não encontro o serviço Suricato Player na lista de serviços.</strong></summary>

Verifique se o **SuriPlayerService** foi instalado corretamente antes de realizar o teste.

</details>

<details>

<summary><strong>O serviço inicia, mas não aparece a mensagem de sucesso no Event Viewer.</strong></summary>

Verifique se está acessando o caminho correto em **Logs de Aplicativos e Serviços > Suricato** e se selecionou o evento mais recente.

</details>

<details>

<summary><strong>O antivírus pode interferir no funcionamento do SuriPlayer?</strong></summary>

Sim. Caso o arquivo **OCX** seja removido ou colocado em quarentena, o serviço pode não iniciar corretamente.

</details>

<details>

<summary><strong>A mensagem no Event Viewer é diferente da mensagem de sucesso. O que significa?</strong></summary>

Isso indica que o serviço encontrou algum erro durante a inicialização. Nesse caso, utilize a mensagem exibida na aba **Geral** para análise e correção.

</details>


---

# 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-servico-suriplayer/testando-o-suriplayer.md?ask=<question>
```

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.