> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.2/wedocs-5.1/gerenciador-de-tarefas/gerenciador-de-tarefas/configuracoes.md).

# Configurações

Weknow Gerenciador de Tarefas

Na tela inicial que é aberta, é exibido o botão de **Configuração** em dois lugares, ambos levam ao mesmo local, porém, no botão próximo a "Verificação de novas atualizações disponíveis" direciona o usuário para a sessão correspondente.

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/BJicyQ7Swgb8lxugRE7i/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

Ao clicar em configurações, na tela que foi aberta, são listadas todas as configurações de Tarefas. Quando clicamos em uma delas, a visão é expandida exibindo os campos para configurar. Mostraremos com um pouco de detalhes, cada um destes menus expandidos:

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/HlQ6vjEYTBhwUaEOYyAb/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

## Repositório de sistema

A configuração relacionada ao repositório do sistema é a responsável pela configuração de acesso ao Weknow Server e ao Weknow Gerenciador de Tarefas.

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/ipnK7lOiHRYUe8oAibmV/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

## URL pública / Cliente web encapsulado

Nessa configuração é possível fazer a configuração de links públicos ou compartilhados, que permitem o acesso aos dashboards por meio de dispositivos de dentro ou fora da rede, alem disso, é possível fazer a configuração do cliente web encapsulado dentro do Weknow Desktop.

* Protocolo servidor;
  * vazio - Será utilizado o padrão - htpp;
  * htpp - Para cassos gerais;
  * https - Para casos em que necessitamos de um certificado;
* Endereço servidor;
  * Endereço do servidor para acesso ao cliente web;
* Porta servidor - Porta de acesso padrão da aplicação;
  * Ao definir o padrão 80, não será necessário informá-la no link;
* Protocolo API;
  * vazio -  Será utilizado o padrão - htpp;
  * http - Para casos gerais;
  * https - Para casos em que necessitamos de um certificado;
* Endereço API - É o endereço de API utilizado no cliente web encapsulado;
* Protocolo API - Porta de acesso ao cliente web encapsulado;
* Sufixo API - Sufixo da URL utilizado no cliente web encapsulado.

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/4ywbwBookAUDAGhHeITx/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

## SMTP

São as configurações relacionadas ao servidor de e-mail, para envio dos links compartilhados e notificações para os usuários definidos no **Cliente Desktop.**

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/0MzC8psDaMGdaPxWKolr/image.png" alt="" width="416"><figcaption></figcaption></figure></div>

Após definir as configurações do servidor de envio de e-mail, clicamos em testar e definimos um e-mail destinatário para verificar se tudo está correto.

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/A5WIZsvClakJWpZbh74K/image.png" alt="" width="353"><figcaption></figcaption></figure></div>

Clique em **OK**, para realizar o envio.

## Cache de Dados

Aqui definimos o período limite, em minutos, para expiração dos dados armazenados em Cache, ou seja, sua exclusão definitiva.

<div align="left"><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/iJyJOwTYTgXjdZh80RWv/image.png" alt="" width="563"></div>

> Isso não tem relação com a geração de dados. Apenas com a exclusão dos mesmos.

## Exportação para .xlsx

Essa opção garante que todo documento **.xlsx** gerado, tenham todas as colunas dimensionadas de acordo com o maior "conteúdo" listado. Não sobrepondo-os.

<div align="left"><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/dulTzBtJLKOsL6Pc8LJM/image.png" alt="" width="563"></div>

## Backup

Aqui apontamos para a pasta "bin", dentro do diretório de instalação do Banco de dados Postgres, lugar onde se encontra a base de dados do weKnow.

<div align="left"><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/eXeXNxtkh4IP8SmrwTRe/image.png" alt="" width="563"></div>

Estas configurações são utilizadas para o funcionamento do Backup da Conta, que é realizado no weKnow Servidor -> Contar, conforme documentação:&#x20;

{% content-ref url="/pages/lkr083MGX8sVregZ6wn8" %}
[Backup](/wedocs-5.2/wedocs-5.1/instalacao-e-atualizacao/weknow-servidor/backup.md)
{% endcontent-ref %}

## Notificação de atualizações

Nesta opção, definimos o e-mail do usuário que recebera a notificação sobre novas atualizações disponíveis.

<div align="left"><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/rVunfDalSnyZYSdn3t7V/image.png" alt="" width="563"></div>

{% content-ref url="/pages/RPDGnXg2pv0nySK1RfQQ" %}
[Notificação sobre novas Versões](/wedocs-5.2/wedocs-5.1/gerenciador-de-tarefas/notificacao-sobre-novas-versoes.md)
{% endcontent-ref %}

## Proxy

No caso do Weknow Servidor estar instalado numa rede fechada, é necessário definir o caminho para o servidor Proxy, onde é feita a ligação com a rede externa.

> Estas configurações devem ser fornecidas pela equipe de T.I. da empresa.

<div align="left"><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/143nHv7D4c5wsgep1xAZ/image.png" alt="" width="563"></div>

## Formatação de valores

A formatação de valores definida aqui, implica nos padrões iniciais de cada um dos componentes. E também aos conteúdos exportados.

<div align="left"><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/E8k4ckYnZPjMRJIioseb/image.png" alt="" width="563"></div>

## Armazenamento off-line

Para armazenar dados offline, o Weknow utiliza o MonetDB/DuckDB, estas informações vêm configuradas com os padrões.

> No caso de dúvida, não tenha receio em contatar o Suporte para esta configuração.

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/fD1JVzqBoBNYpqJmuz5D/image.png" alt="" width="424"><figcaption></figcaption></figure></div>

Timeout (segundos):  0 significa que não tem timeout. Se um timeout for configurado, sempre que a geração dos dados offline de um metadado offline ultrapassar o timeout, um erro de timeout ocorrerá e a geração será abortada.

#### **Diretórios CSV**

Os dados são enviados do Weknow ao MonetDB/DuckDB por arquivos CSV. Para isso, dois campos foram adicionados à configuração:

**Diretório CSV (escrita)**

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/xBezN60LhQ7i9ycg7KIS/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

> **Função:**&#x20;
>
> Diretório onde o *weKnow* irá **salvar** os arquivos CSV que serão lidos posteriormente pelo *MonetDB* e/ou *DuckDB*.
>
> **Configuração:**
>
> * Se o *MonetDB* estiver **nesta máquina**, informe o caminho local ou deixe o campo vazio para que o sistema utilize um diretório temporário automaticamente.
> * Se o *MonetDB* estiver em **outra máquina**, informe um **caminho de rede acessível** por essa máquina.
>
> **Exemplo:**
>
> * Local: `C:\weknow\csv_out`
> * Rede: `\\servidor\compartilhamento\csv_out`

**Diretório CSV (leitura)**

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/lwNwXK0kXKq11Na56eIE/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

> **Função:**&#x20;
>
> Diretório de onde o *MonetDB* irá **ler** os arquivos CSV gerados pelo sistema.
>
> **Configuração:**
>
> * Essa pasta deve estar **na máquina onde o&#x20;*****MonetDB*****&#x20;está instalado**.
> * O caminho deve ser **local**, mesmo que o banco esteja em outro computador.
>
> **Exemplo:**
>
> * Local: `/home/monetdb/csv_in`
>
> **Importante**:&#x20;
>
> Se o *MonetDB* estiver em outra máquina, informe o caminho conforme reconhecido por **essa outra máquina**, e não um caminho de rede.

## Atualização da licença

Aqui temos as configurações do servidor de licenças do Weknow, por padrão, isto já vem definido.

> Essa alteração só será necessária se solicitada pelo Suporte.

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/KFfC7xlRrXSBjxKnnN6P/image.png" alt="" width="413"><figcaption></figcaption></figure></div>

## JWT

Para garantir a segurança durante as conexões e credenciamentos, utilizamos o JWT, um padrão mundialmente utilizado na Web. Onde, durante o credenciamento, são criadas duas chaves, uma pública e outra privada, que serão trocadas durante toda a comunicação.

O período de expiração corresponde a validade dessa chave privada, ou seja, após o credenciamento, o tempo que o usuário tem disponível até que precise se credenciar novamente.

<div align="left"><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/3nGXRudTdGwpMroWzSBK/image.png" alt="" width="563"></div>

## Execução do Metadado

Está opção transcreve as fórmulas de listagem para SQL sempre que possível, isso facilita na manutenção das buscas, e na possível utilização por aplicações externas.

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/t1afrdO9kpK4PYSbMYkN/image.png" alt="" width="413"><figcaption></figcaption></figure></div>

* Ao clicar em *Configurações avançadas de conexão* o usuário pode configurar parâmetros avançados para conexões com fontes de dados:

<figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/Ugs538MFPhsBVbP4b9Fc/image.png" alt=""><figcaption></figcaption></figure>

> Seleção de Tipo de Conexão
>
> * No topo da tela, o usuário deve selecionar o **Tipo de conexão** ao qual deseja aplicar as configurações.
> * Essa seleção define o escopo das opções exibidas e aplicáveis.
>
> Filtro de Configurações
>
> * Logo abaixo do campo de tipo de conexão, há uma barra de busca que permite **filtrar as configurações exibidas**.
> * O filtro facilita a localização de opções específicas.
>
> Botão "Opções..."
>
> Ao clicar no botão **Opções...**, um menu flutuante é exibido com as seguintes ações:
>
> * **Restaurar valores**: redefine todas as configurações para seus valores padrão.
> * **Exibir apenas valoresdefinidos**: exibe apenas configurações que possuem valores definidos.
> * **Copiar para a área de transferência**: exporta todas as configurações atuais.
> * **Colar configurações da área de transferência**: importa configurações previamente copiadas.
> * **Colar configurações da área de transferência (apenas explicitamente definidos)**: importa configurações previamente copiadas.
>
> Exibição das Configurações
>
> * Cada linha representa uma **configuração individual**.
> * Os **valores preenchidos** são destacados em **negrito**.
> * Um **botão de restaurar** é exibido ao lado de cada configuração com valor definido.
>
> Tipos de Configuração
>
> * Algumas configurações possuem **valores fixos**, definidos pelo sistema.
> * Outras são **valores livres**, permitindo ao usuário inserir qualquer texto.
> * Configurações livres podem incluir **valores sugeridos**, exibidos como auxílio.
>
> Informações Adicionais
>
> * Ao lado de cada configuração, é exibido o **valor padrão**.
> * Ao **passar o mouse** sobre o valor padrão, o sistema mostra **a origem da herança** da configuração.
> * Ao **clicar com o botão direito** sobre um valor, é possível **copiá-lo individualmente** para a área de transferência.

## Serviços

Nessa opção será possível definir a quantidade de instâncias que serão executadas simultaneamente.

<mark style="color:blue;">**Os serviços permitidos**</mark>:

* Execução Tarefas;
* Envio de E-mails;
* Envio de SMS;
* Envio de mensagens pelo Telegram;
* Geração de carga offline de Metadado (agendados);
* Geração de carga offline de Metadado (executar agora);
* Geração de carga offline de Metadado (grupos);
* Cache de Conexões;
* Sincronização do Telegram;
* Envio WhatsApp;
* Geração de miniaturas de Dashboard;
* Variáveis Dinâmicas;

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/JInLWOnu3tKIgACcLvBv/image.png" alt="" width="385"><figcaption></figcaption></figure></div>

{% hint style="danger" %}
Lembrando que o valor mínimo é 1 e o valor máximo é 8.
{% endhint %}

É possível visualizar no Painel de Controle quantos serviços (Instâncias) estão em execução no momento:

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/AX2WLqF8P4x0aY0nQ2Qg/image.png" alt="" width="346"><figcaption></figcaption></figure></div>

## Renomear os serviços

Também é possível renomear os serviços do Weknow Servidor e Weknow Gerenciador de Tarefas.

Para renomear você deve entrar na pasta "<mark style="color:orange;">**\Common\Configs\config.ini**</mark>" e informar os seguintes dados:

{% hint style="info" %}
\[server]&#x20;

serviceNamePrefix=&#x20;

serviceName=&#x20;

serviceNameSuffix=

\[taskManager]&#x20;

serviceNamePrefix=&#x20;

serviceName=&#x20;

serviceNameSuffix=
{% endhint %}

#### Regras para o nome do serviço:

O nome base do serviço é definido pela propriedade **`serviceName`** se ela existir e não for nula. Do contrário, é utilizado o nome interno padrão.

Os valores definidos em **`serviceNamePrefix`** e **`serviceNameSuffix`** são adicionados no início e fim, respectivamente, do nome do serviço.

Apenas letras e números são utilizados. Outros caracteres são substituídos por **\_**.

#### Regras para o nome de exibição do serviço:

* O nome de exibição base do serviço é definido pela propriedade **serviceName** se ela existir e não for nula. Do contrário, é utilizada a tradução, se houver. Senão, o nome interno padrão é usado.
* Os valores definidos em **serviceNamePrefix** e **serviceNameSuffix** são adicionados no início e fim, respectivamente, do nome do serviço (entre parêntesis):

  **(prefixo) nome de exibição (sufixo)**
* Estes dois serviços devem ser instalados pelo iniciador correspondente para que estas configurações tenham efeito.

Para os serviços do Servidor, GT e MonetDB é possível definir qualquer nome e nome de exibição instalando-os pela linha de comando:

{% hint style="info" %}
sc create \<serviceName> binpath= "\<path> -sn \\"\<serviceName>\\"" displayname="\<displayName>"
{% endhint %}

serviceName: é o nome que se deseja dar ao serviço. Note que este nome é utilizado em dois locais no comando acima e devem ser idênticos. A utilização indevida poderá resultar em um mau funcionamento.

path: é o caminho do executável do serviço que se deseja instalar;

* \<weknow>\server\wknw\_server.exe;
* \<weknow>\task\_manager\wknw\_task\_manager.exe
* \<weknow>\monetdb\wknw\_monetdb.exe

displayName: é o nome de exibição que se deseja dar ao serviço. Este parâmetro é opcional.

## Aparência

A opção **Tema de Sistema** permite ao usuário personalizar a aparência visual da aplicação, escolhendo entre estilos predefinidos que afetam cores, espaçamentos, fontes e outros elementos da interface.

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/2Si964pbnIBeRez6Ebfn/image.png" alt="" width="381"><figcaption></figcaption></figure></div>

> Após ajustar as configurações de aparência, acesse a seção "Temas" no Weknow e, em "Tema Base", selecione o tema do sistema.

## Logs

Aqui são definidos quais casos serão registrados nos logs da aplicação. Os **Alertas** e **Erros** são recomentados, pois em uma eventualidade, serão utilizados pelo Suporte para investigação do problema.

O Log de informações é um Log muito extenso que corresponde a qualquer operação realizada no sistema, seja de: Leitura, Escrita, Edição ou exclusão.

> Caso o Log de **Informações** seja ativado, é recomentado que a limpeza dos Logs também esteja ativada, para não sobrecarregar o banco de dados.

<div align="left"><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/qsvPVwAbtFIBtG8SzEqb/image.png" alt=""></div>

## Python

O usuário define manualmente o diretório da instalação do Python que será utilizada pelos módulos do sistema. Essa funcionalidade oferece maior flexibilidade e controle sobre o ambiente de execução dos scripts Python.

<div align="left"><figure><img src="https://content.gitbook.com/content/4yXt6ny2DDnDTHV2uaYY/blobs/cccvFiE849yX6OTBvbu7/image.png" alt="" width="384"><figcaption></figcaption></figure></div>

> **Se o diretório informado contiver uma instalação válida do Python**\
> O WK utilizará essa instalação como ambiente principal para execução de scripts Python, garantindo maior controle e isolamento de dependências.
>
> **Se nenhum diretório for especificado**\
> O WK tentará utilizar uma instalação padrão do Python já registrada no sistema operacional Windows. Essa instalação pode ter sido feita previamente por outro software ou pelo próprio usuário.

&#x20;