DPServer - Serviço - Histórico de revisão

Mario em 13h00min de 23 de junho de 2026

2026-06-23T13:00:56Z

← Edição anterior		Edição das 10h00min de 23 de junho de 2026
Linha 3:		Linha 3:

	== 💻 1. ESCOPO DO DESENVOLVIMENTO ==		== 💻 1. ESCOPO DO DESENVOLVIMENTO ==
	Para abertura do projeto do dpServer é necessário a instalação da extensão Microsoft Visual Studio Installer Projects 2022 acessando o menu Extensões / Gerenciar Extensões.		Para abertura do projeto do dpServer é necessário a instalação da extensão '''Microsoft Visual Studio Installer Projects 2022''' acessando o menu '''Extensões / Gerenciar Extensões'''.

	=== Alteração da Versão do Executável (Assembly) ===		=== Alteração da Versão do Executável (Assembly) ===

Mario em 12h59min de 23 de junho de 2026

2026-06-23T12:59:34Z

← Edição anterior		Edição das 09h59min de 23 de junho de 2026
Linha 3:		Linha 3:

	== 💻 1. ESCOPO DO DESENVOLVIMENTO ==		== 💻 1. ESCOPO DO DESENVOLVIMENTO ==
			Para abertura do projeto do dpServer é necessário a instalação da extensão Microsoft Visual Studio Installer Projects 2022 acessando o menu Extensões / Gerenciar Extensões.

	=== Alteração da Versão do Executável (Assembly) ===		=== Alteração da Versão do Executável (Assembly) ===
Linha 35:		Linha 36:

	# Desinstalar o Aplicativo dpServer do servidor (caso esteja instalado)		# Desinstalar o Aplicativo dpServer do servidor (caso esteja instalado)
	# Remover a chave do registro do Windows responsável por iniciar o aplicativo junto com o Windows (acessar o editor do registro (Regedit) e excluir dpServerApp no seguinte caminho: Computador\HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run)		# Remover a chave do registro do Windows responsável por iniciar o aplicativo junto com o Windows (acessar o editor do registro (pressione '''Win + R''' e digite Regedit) e excluir dpServerApp no seguinte caminho: Computador\HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run)
	# Executar o instalador <code>.msi</code> padrão no servidor do cliente.		# Executar o instalador <code>.msi</code> padrão no servidor do cliente.

Mario em 10h25min de 23 de junho de 2026

2026-06-23T10:25:11Z

← Edição anterior		Edição das 07h25min de 23 de junho de 2026
Linha 32:		Linha 32:

	* '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.		* '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.
	* '''Como fazer:''' 1. Executar o instalador <code>.msi</code> padrão no servidor do cliente.		* '''Como fazer:'''
	* '''Pasta de instalação: P'''asta de arquivos de instalações dos outros sistemas.
			# Desinstalar o Aplicativo dpServer do servidor (caso esteja instalado)
			# Remover a chave do registro do Windows responsável por iniciar o aplicativo junto com o Windows (acessar o editor do registro (Regedit) e excluir dpServerApp no seguinte caminho: Computador\HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run)
			# Executar o instalador <code>.msi</code> padrão no servidor do cliente.

			- '''Pasta de instalação: P'''asta de arquivos de instalações dos outros sistemas.

	Clique em '''avançar''':		Clique em '''avançar''':
	[[Arquivo:Instalação setup .msi 1 - dpServerService.png\|centro\|miniaturadaimagem\|471x471px]]		[[Arquivo:Instalação setup .msi 1 - dpServerService.png\|centro\|miniaturadaimagem\|471x471px]]
Linha 44:		Linha 50:
	Aguarde a instalação concluir e clique em '''fechar'''.		Aguarde a instalação concluir e clique em '''fechar'''.

	* 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação Ex: <code>C:\Program Files (x86)\...\dpServerService.Setup</code>.		4. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação Ex: <code>C:\Program Files (x86)\...\dpServerService.Setup</code>.
	* 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz. Criar uma pasta para os arquivos do '''dpServer''' (Ex: <code>value="SUGESTÃO: CAMINHO_PASTA_DE_ARQUIVOS_DOS_SISTEMAS"</code>).
			5. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz. Criar uma pasta para os arquivos do '''dpServer''' (Ex: <code>value="SUGESTÃO: CAMINHO_PASTA_DE_ARQUIVOS_DOS_SISTEMAS"</code>).
	[[Arquivo:AppConfig - dpServerService.png\|centro\|miniaturadaimagem\|711x711px]]		[[Arquivo:AppConfig - dpServerService.png\|centro\|miniaturadaimagem\|711x711px]]
	* 4. Verificar se as credenciais do email estão corretas.		* 6. Verificar se as credenciais do email estão corretas.
	* 5. Configurar as informações do banco de dados (dbServer e DataBase).		* 7. Configurar as informações do banco de dados (dbServer e DataBase).
	* 6. Informar o código da empresa ativa. (A empresa configurada servirá como padrão para as regras de negócio que não possuem essa informação).		* 8. Informar o código da empresa ativa. (A empresa configurada servirá como padrão para as regras de negócio que não possuem essa informação).

	== 🛠️ 3. VERIFICAR STATUS DO SERVIÇO (PÓS INSTALAÇÃO) ==		== 🛠️ 3. VERIFICAR STATUS DO SERVIÇO (PÓS INSTALAÇÃO) ==

Vinicius em 11h42min de 11 de junho de 2026

2026-06-11T11:42:22Z

← Edição anterior		Edição das 08h42min de 11 de junho de 2026
Linha 33:		Linha 33:
	* '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.		* '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.
	* '''Como fazer:''' 1. Executar o instalador <code>.msi</code> padrão no servidor do cliente.		* '''Como fazer:''' 1. Executar o instalador <code>.msi</code> padrão no servidor do cliente.
			* '''Pasta de instalação: P'''asta de arquivos de instalações dos outros sistemas.
	Clique em '''avançar''':		Clique em '''avançar''':
	[[Arquivo:Instalação setup .msi 1 - dpServerService.png\|centro\|miniaturadaimagem\|471x471px]]		[[Arquivo:Instalação setup .msi 1 - dpServerService.png\|centro\|miniaturadaimagem\|471x471px]]
Linha 44:		Linha 45:

	* 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação Ex: <code>C:\Program Files (x86)\...\dpServerService.Setup</code>.		* 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação Ex: <code>C:\Program Files (x86)\...\dpServerService.Setup</code>.
	* 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz ~~acordada~~ (Ex: <code>value="C:~~\DpServer\~~"</code>)~~. '''Sugestão:''' pasta de arquivos de instalações dos outros sistemas~~.		* 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz. Criar uma pasta para os arquivos do '''dpServer''' (Ex: <code>value="SUGESTÃO: CAMINHO_PASTA_DE_ARQUIVOS_DOS_SISTEMAS"</code>).
	[[Arquivo:AppConfig - dpServerService.png\|centro\|miniaturadaimagem\|711x711px]]		[[Arquivo:AppConfig - dpServerService.png\|centro\|miniaturadaimagem\|711x711px]]
	* 4. Verificar se as credenciais do email estão corretas.		* 4. Verificar se as credenciais do email estão corretas.
Linha 50:		Linha 51:
	* 6. Informar o código da empresa ativa. (A empresa configurada servirá como padrão para as regras de negócio que não possuem essa informação).		* 6. Informar o código da empresa ativa. (A empresa configurada servirá como padrão para as regras de negócio que não possuem essa informação).

	==~~= Iniciando o serviço~~. ===		== 🛠️ 3. VERIFICAR STATUS DO SERVIÇO (PÓS INSTALAÇÃO) ==
	'''Primeira Instalação:''' > Após concluir as configurações nos arquivos, é válido verificar se o serviço do Windows foi iniciado. Siga os passos abaixo:		'''Primeira Instalação:''' > Após concluir as configurações nos arquivos, o serviço será inicializado automaticamente, é válido verificar se o serviço do Windows foi iniciado. Siga os passos abaixo:

	# Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.		# Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.
	# Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").		# Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").
	# Certifique-se de que o status na coluna correspondente está em '''"Em execução"'''. Caso esteja '''"Iniciando"''' aguarde alguns segundos e atualize.[[Arquivo:Serviços - dpServerServico.png\|centro\|miniaturadaimagem\|712x712px]]		# Certifique-se de que o status na coluna correspondente está em '''"Em execução"'''. Caso esteja '''"Iniciando"''' aguarde alguns segundos e atualize.[[Arquivo:Serviços - dpServerServico.png\|centro\|miniaturadaimagem\|712x712px]]

			== 🛠️ 4. ATUALIZAÇÃO ==

	=== Aplicação de Atualizações (Update de Versão) ===		=== Aplicação de Atualizações (Update de Versão) ===
	* Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>~~C:\DpServer~~\Atualizacao</code>).
			* Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>CAMINHO_PASTA_DE_ARQUIVOS_DOS_SISTEMAS\Atualizacao</code>).
	* Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.		* Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.
	* O serviço detectará os arquivos novos, fará a substituição e reiniciará de forma 100% automatizada em até 5 minutos.		* O serviço detectará os arquivos novos, fará a substituição e reiniciará de forma 100% automatizada em até 5 minutos.

	== 🔍 3. GUIA DE RESOLUÇÃO DE PROBLEMAS ==		== 🔍 5. GUIA DE RESOLUÇÃO DE PROBLEMAS ==
	Se a atualização falhar ou o serviço não iniciar, o Atendimento deve seguir este roteiro de checagem:		Se a atualização falhar ou o serviço não iniciar, o Atendimento deve seguir este roteiro de checagem:

Vinicius em 14h52min de 10 de junho de 2026

2026-06-10T14:52:24Z

← Edição anterior		Edição das 11h52min de 10 de junho de 2026
Linha 51:		Linha 51:

	=== Iniciando o serviço. ===		=== Iniciando o serviço. ===
	'''Primeira Instalação:''' > Após concluir as configurações nos arquivos ~~(incluindo o <code>DpSettings.xml</code>)~~, ~~será necessário iniciar~~ o serviço do Windows. Siga os passos abaixo:		'''Primeira Instalação:''' > Após concluir as configurações nos arquivos, é válido verificar se o serviço do Windows foi iniciado. Siga os passos abaixo:

	# Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.		# Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.
	# Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").		# Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").
	~~# Clique em '''Iniciar'''.~~		# Certifique-se de que o status na coluna correspondente está em '''"Em execução"'''. Caso esteja '''"Iniciando"''' aguarde alguns segundos e atualize.[[Arquivo:Serviços - dpServerServico.png\|centro\|miniaturadaimagem\|712x712px]]
	# Certifique-se de que o status na coluna correspondente ~~mudou para~~ '''"Em execução"'''.[[Arquivo:Serviços - dpServerServico.png\|centro\|miniaturadaimagem\|712x712px]]

	=== Aplicação de Atualizações (Update de Versão) ===		=== Aplicação de Atualizações (Update de Versão) ===

Vinicius em 14h26min de 10 de junho de 2026

2026-06-10T14:26:40Z

← Edição anterior		Edição das 11h26min de 10 de junho de 2026
Linha 43:		Linha 43:
	Aguarde a instalação concluir e clique em '''fechar'''.		Aguarde a instalação concluir e clique em '''fechar'''.

	* 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação <code>C:\Program Files (x86)\...\dpServerService.Setup</code>.		* 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação Ex: <code>C:\Program Files (x86)\...\dpServerService.Setup</code>.
	* 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz acordada (Ex: <code>value="C:\DpServer\"</code>). [[Arquivo:~~Caminho arquivos~~ - dpServerService.png\|centro\|miniaturadaimagem\|~~661x661px~~]]		* 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz acordada (Ex: <code>value="C:\DpServer\"</code>). '''Sugestão:''' pasta de arquivos de instalações dos outros sistemas.
			[[Arquivo:AppConfig - dpServerService.png\|centro\|miniaturadaimagem\|711x711px]]
	* 4. Verificar se as credenciais do email estão corretas.		* 4. Verificar se as credenciais do email estão corretas.
			* 5. Configurar as informações do banco de dados (dbServer e DataBase).
	~~=== Gestão~~ do ~~Arquivo DpSettings.xml ===~~		* 6. Informar o código da empresa ativa. (A empresa configurada servirá como padrão para as regras de negócio que não possuem essa informação).

	* '''O que fazer:''' Garantir que o arquivo de conexão com o banco de dados ~~esteja no local correto determinado pela configuração~~ (~~Deve ser disponibilizado na pasta de instalação~~).
	~~'''Como fazer:''' Copiar~~ o ~~arquivo <code>DpSettings~~.~~xml</code> do cliente e colá-lo dentro da pasta raiz~~ configurada ~~na chave <code>CaminhoArquivos</code> (Ex: dentro~~ de ~~<code>C:\DpServer\</code>~~).~~[[Arquivo:DpSettings - dpServerService.png\|miniaturadaimagem\|448x448px\|centro]]~~

	=== Iniciando o serviço. ===		=== Iniciando o serviço. ===
Linha 71:		Linha 69:

	* '''Causa 1:''' Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta <code>\Atualizacao</code>.		* '''Causa 1:''' Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta <code>\Atualizacao</code>.
	* '''Causa 2:''' O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo <code>.exe</code> enviado pelo Dev, vá na aba ''Detalhes'' e verifique se a versão é realmente maior do que a que já está rodando.[[Arquivo:Propriedades - dpServerService.png~~\|nenhum~~\|miniaturadaimagem\|529x529px]]		* '''Causa 2:''' O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo <code>.exe</code> enviado pelo Dev, vá na aba ''Detalhes'' e verifique se a versão é realmente maior do que a que já está rodando.[[Arquivo:Propriedades - dpServerService.png\|miniaturadaimagem\|529x529px\|centro]]

	=== Onde verificar o que aconteceu? ===		=== Onde verificar o que aconteceu? ===

	# '''Logs do dpServer:''' Para visualizar os logs, basta dar um duplo clique sobre o ícone de status.:[[Arquivo:Logs do DpServer - dpServerService.png~~\|nenhum~~\|miniaturadaimagem\|847x847px]]		# '''Logs do dpServer:''' Para visualizar os logs, basta dar um duplo clique sobre o ícone de status.:[[Arquivo:Logs do DpServer - dpServerService.png\|miniaturadaimagem\|847x847px\|centro]]
	# '''No arquivo de texto:''' Abra o arquivo <code>dpServerApp.log</code> localizado diretamente na pasta raiz configurada do cliente[[Arquivo:Logs do DpServer .txt - dpServerService.png~~\|nenhum~~\|miniaturadaimagem\|766x766px]]		# '''No arquivo de texto:''' Abra o arquivo <code>dpServerApp.log</code> localizado diretamente na pasta raiz configurada do cliente[[Arquivo:Logs do DpServer .txt - dpServerService.png\|miniaturadaimagem\|766x766px\|centro]]
	# '''E-mail de avisos:''' Diferente dos outros logs, o log de e-mail será '''enviado''' somente quando ocorrerem erros no processamento:[[Arquivo:Logs do DpServer e-mail - dpServerService.png~~\|nenhum~~\|miniaturadaimagem\|766x766px]]		# '''E-mail de avisos:''' Diferente dos outros logs, o log de e-mail será '''enviado''' somente quando ocorrerem erros no processamento:[[Arquivo:Logs do DpServer e-mail - dpServerService.png\|miniaturadaimagem\|766x766px\|centro]]

Vinicius em 13h29min de 29 de maio de 2026

2026-05-29T13:29:40Z

← Edição anterior		Edição das 10h29min de 29 de maio de 2026
Linha 2:		Linha 2:
	Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.		Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.

	=== 💻 1. ESCOPO DO DESENVOLVIMENTO ===		== 💻 1. ESCOPO DO DESENVOLVIMENTO ==

	=== Alteração da Versão do Executável (Assembly) ===		=== Alteração da Versão do Executável (Assembly) ===

Vinicius em 13h29min de 29 de maio de 2026

2026-05-29T13:29:01Z

← Edição anterior		Edição das 10h29min de 29 de maio de 2026
Linha 2:		Linha 2:
	Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.		Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.

	== 💻 1. ESCOPO DO DESENVOLVIMENTO ==		=== 💻 1. ESCOPO DO DESENVOLVIMENTO ===

	=== Alteração da Versão do Executável (Assembly) ===		=== Alteração da Versão do Executável (Assembly) ===

Vinicius: /* 💻 1. ESCOPO DO DESENVOLVIMENTO */

2026-05-29T13:28:01Z

💻 1. ESCOPO DO DESENVOLVIMENTO

Vinicius em 13h05min de 29 de maio de 2026

2026-05-29T13:05:29Z

← Edição anterior		Edição das 10h05min de 29 de maio de 2026
Linha 2:		Linha 2:
	Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.		Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.

	== 💻 1. ESCOPO DO DESENVOLVIMENTO ~~(Dev)~~ ==		== 💻 1. ESCOPO DO DESENVOLVIMENTO ==

	=== 1.1. Alteração da Versão do Executável (Assembly) ===		=== 1.1. Alteração da Versão do Executável (Assembly) ===

	* Incrementar o número da versão física do arquivo sempre que houver modificações.		* Incrementar o número da versão física do arquivo sempre que houver modificações.
	* '''Como fazer:''' No Visual Studio, acesse as propriedades do projeto <code>dpServerService</code> -> Aba '''Aplicativo''' -> Botão '''Informações do Assembly...''' -> Incremente a '''Versão do assembly''' e '''Versão do arquivo''' (Ex: <code>1.0.0.0</code> para <code>1.1.0.0</code>).[[Arquivo:Mudança de versão - dpServerService.png\|~~nenhum~~\|~~miniaturadaimagem~~\|~~570x570px~~]]		* '''Como fazer:''' No Visual Studio, acesse as propriedades do projeto <code>dpServerService</code> -> Aba '''Aplicativo''' -> Botão '''Informações do Assembly...''' -> Incremente a '''Versão do assembly''' e '''Versão do arquivo''' (Ex: <code>1.0.0.0</code> para <code>1.1.0.0</code>).[[Arquivo:Mudança de versão - dpServerService.png\|miniaturadaimagem\|785x785px\|centro]]
	* ''Nota:'' Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.		* ''Nota:'' Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.

Linha 15:		Linha 15:

	=== 1.3. Compilação e Geração do Instalador (.msi) ===		=== 1.3. Compilação e Geração do Instalador (.msi) ===
			Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.

	O projeto possui um projeto de Setup integrado (usando Microsoft Visual Studio Installer Projects).		O projeto possui um projeto de Setup integrado (usando Microsoft Visual Studio Installer Projects).
	~~Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.~~
	⚠️ '''REGRA:''' '''NUNCA''' inclua o arquivo <code>dpServerService.exe.config</code> (App.Config) no pacote de atualização. O envio deste arquivo destrói as configurações customizadas do cliente, pois é lá que fica configurado o caminho dos arquivos de atualização.

	# Na janela do ''Solution Explorer'', localize o projeto de instalação (~~geralmente chamado '''<code>dpServerSetup</code>''' ou~~ '''<code>Setup</code>''').		# Na janela do ''Solution Explorer'', localize o projeto de instalação ('''<code>dpServerService.Setup</code>''') .
	# Clique com o botão direito sobre o projeto '''<code>~~dpServerSetup~~</code>''' e selecione '''Compilar''' (''Build'') ou ''Rebuild''.		# Clique com o botão direito sobre o projeto '''<code>dpServerService.Setup</code>'''e selecione '''Compilar''' (''Build'') ou ''Rebuild''.
	# O Visual Studio gerará os arquivos de instalação na pasta de saída do setup.		# O Visual Studio gerará os arquivos de instalação na pasta de saída do setup.
	# Navegue até a pasta física do projeto de setup (Ex: <code>...\</code><code>dpServerService.Setup\Release\</code>) e copie o arquivo '''<code>dpServerService.Setup</code>''' (e o <code>setup.exe</code> se houver).		# Navegue até a pasta física do projeto de setup (Ex: <code>...\</code><code>dpServerService.Setup\Release\</code>) e copie o arquivo '''<code>dpServerService.Setup.msi</code>''' (e o <code>setup.exe</code> se houver).
	# Disponibilize ~~este arquivo~~ '''~~.setup~~''' ~~para a equipe~~ de ~~Atendimento~~.		# Disponibilize estes arquivos para a equipe de Atendimento.
			⚠️ '''REGRA:''' '''NUNCA''' inclua o arquivo <code>dpServerService.exe.config</code> (App.Config) no pacote de atualização. O envio deste arquivo destrói as configurações customizadas do cliente, pois é lá que fica configurado o caminho dos arquivos de atualização.

	== 🛠️ 2. ESCOPO DO ATENDIMENTO / SUPORTE ==		== 🛠️ 2. ESCOPO DO ATENDIMENTO / SUPORTE ==
Linha 31:		Linha 32:

	* '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.		* '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.
	* '''Como fazer:''' 1. Executar o instalador <code>.~~setup~~</code> padrão no servidor do cliente. 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação. 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz acordada (Ex: <code>value="C:\DpServer\"</code>). 4. Verificar se as credenciais do email estão corretas.		* '''Como fazer:''' 1. Executar o instalador <code>.msi</code> padrão no servidor do cliente.
			Clique em '''avançar''':
			[[Arquivo:Instalação setup .msi 1 - dpServerService.png\|centro\|miniaturadaimagem\|471x471px]]
			Escolha o caminho de instalação e clique em '''avançar''':
			[[Arquivo:Instalação setup .msi 2 - dpServerService.png\|centro\|miniaturadaimagem\|486x486px]]
			Clique em '''avançar''':
			[[Arquivo:Instalação setup .msi 3 - dpServerService.png\|centro\|miniaturadaimagem\|496x496px]]


			Aguarde a instalação concluir e clique em '''fechar'''.

			* 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação <code>C:\Program Files (x86)\...\dpServerService.Setup</code>.
			* 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz acordada (Ex: <code>value="C:\DpServer\"</code>). [[Arquivo:Caminho arquivos - dpServerService.png\|centro\|miniaturadaimagem\|661x661px]]
			* 4. Verificar se as credenciais do email estão corretas.

	=== 2.2. Gestão do Arquivo DpSettings.xml ===		=== 2.2. Gestão do Arquivo DpSettings.xml ===

	* '''O que fazer:''' Garantir que o arquivo de conexão com o banco de dados esteja no local correto determinado pela configuração (~~Disponibilizado~~ na pasta de instalação).		* '''O que fazer:''' Garantir que o arquivo de conexão com o banco de dados esteja no local correto determinado pela configuração (Deve ser disponibilizado na pasta de instalação).
	* '''Como fazer:''' Copiar o arquivo <code>DpSettings.xml</code> do cliente e colá-lo dentro da pasta raiz configurada na chave <code>CaminhoArquivos</code> (Ex: dentro de <code>C:\DpServer\</code>).[[Arquivo:DpSettings - dpServerService.png\|~~nenhum~~\|~~miniaturadaimagem~~\|~~422x422px~~]]		'''Como fazer:''' Copiar o arquivo <code>DpSettings.xml</code> do cliente e colá-lo dentro da pasta raiz configurada na chave <code>CaminhoArquivos</code> (Ex: dentro de <code>C:\DpServer\</code>).[[Arquivo:DpSettings - dpServerService.png\|miniaturadaimagem\|448x448px\|centro]]

			=== 2.3. Iniciando o serviço. ===
			'''Primeira Instalação:''' > Após concluir as configurações nos arquivos (incluindo o <code>DpSettings.xml</code>), será necessário iniciar o serviço do Windows. Siga os passos abaixo:

	~~=== 2~~.3. ~~Aplicação de Atualizações~~ (~~Update~~ de ~~Versão) ===~~		# Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.
			# Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").
			# Clique em '''Iniciar'''.
			# Certifique-se de que o status na coluna correspondente mudou para '''"Em execução"'''.[[Arquivo:Serviços - dpServerServico.png\|centro\|miniaturadaimagem\|712x712px]]

			=== 2.4. Aplicação de Atualizações (Update de Versão) ===
	* Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>C:\DpServer\Atualizacao</code>).		* Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>C:\DpServer\Atualizacao</code>).
	* Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.		* Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.
Linha 50:		Linha 71:

	* '''Causa 1:''' Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta <code>\Atualizacao</code>.		* '''Causa 1:''' Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta <code>\Atualizacao</code>.
	* '''Causa 2:''' O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo <code>.exe</code> enviado pelo Dev, vá na aba ''Detalhes'' e verifique se a versão é realmente maior do que a que já está rodando.[[Arquivo:Propriedades - dpServerService.png\|nenhum\|miniaturadaimagem]]		* '''Causa 2:''' O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo <code>.exe</code> enviado pelo Dev, vá na aba ''Detalhes'' e verifique se a versão é realmente maior do que a que já está rodando.[[Arquivo:Propriedades - dpServerService.png\|nenhum\|miniaturadaimagem\|529x529px]]

	=== Onde verificar o que aconteceu? ===		=== Onde verificar o que aconteceu? ===

← Edição anterior		Edição das 10h28min de 29 de maio de 2026
Linha 4:		Linha 4:
	== 💻 1. ESCOPO DO DESENVOLVIMENTO ==		== 💻 1. ESCOPO DO DESENVOLVIMENTO ==

	=== ~~1.1.~~ Alteração da Versão do Executável (Assembly) ===		=== Alteração da Versão do Executável (Assembly) ===

	* Incrementar o número da versão física do arquivo sempre que houver modificações.		* Incrementar o número da versão física do arquivo sempre que houver modificações.
Linha 10:		Linha 10:
	* ''Nota:'' Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.		* ''Nota:'' Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.

	=== ~~1.2.~~ Compilação em Modo Release ===		=== Compilação em Modo Release ===

	* Alterar o seletor do Visual Studio de <code>Debug</code> para '''<code>Release</code>''' e executar o comando '''Recompilar Solução''' (''Rebuild Solution'') dos dois projetos.		* Alterar o seletor do Visual Studio de <code>Debug</code> para '''<code>Release</code>''' e executar o comando '''Recompilar Solução''' (''Rebuild Solution'') dos dois projetos.

	=== ~~1.3.~~ Compilação e Geração do Instalador (.msi) ===		=== Compilação e Geração do Instalador (.msi) ===
	Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.		Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.

Linha 29:		Linha 29:
	O Atendimento é responsável pela implantação no servidor do cliente, configuração dos ambientes, parametrização dos arquivos locais e aplicação de atualizações enviadas pelo desenvolvimento.		O Atendimento é responsável pela implantação no servidor do cliente, configuração dos ambientes, parametrização dos arquivos locais e aplicação de atualizações enviadas pelo desenvolvimento.

	=== ~~2.1.~~ Primeira Instalação e Configuração do Ambiente ===		=== Primeira Instalação e Configuração do Ambiente ===

	* '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.		* '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.
Linha 47:		Linha 47:
	* 4. Verificar se as credenciais do email estão corretas.		* 4. Verificar se as credenciais do email estão corretas.

	=== ~~2.2.~~ Gestão do Arquivo DpSettings.xml ===		=== Gestão do Arquivo DpSettings.xml ===

	* '''O que fazer:''' Garantir que o arquivo de conexão com o banco de dados esteja no local correto determinado pela configuração (Deve ser disponibilizado na pasta de instalação).		* '''O que fazer:''' Garantir que o arquivo de conexão com o banco de dados esteja no local correto determinado pela configuração (Deve ser disponibilizado na pasta de instalação).
	'''Como fazer:''' Copiar o arquivo <code>DpSettings.xml</code> do cliente e colá-lo dentro da pasta raiz configurada na chave <code>CaminhoArquivos</code> (Ex: dentro de <code>C:\DpServer\</code>).[[Arquivo:DpSettings - dpServerService.png\|miniaturadaimagem\|448x448px\|centro]]		'''Como fazer:''' Copiar o arquivo <code>DpSettings.xml</code> do cliente e colá-lo dentro da pasta raiz configurada na chave <code>CaminhoArquivos</code> (Ex: dentro de <code>C:\DpServer\</code>).[[Arquivo:DpSettings - dpServerService.png\|miniaturadaimagem\|448x448px\|centro]]

	=== ~~2.3.~~ Iniciando o serviço. ===		=== Iniciando o serviço. ===
	'''Primeira Instalação:''' > Após concluir as configurações nos arquivos (incluindo o <code>DpSettings.xml</code>), será necessário iniciar o serviço do Windows. Siga os passos abaixo:		'''Primeira Instalação:''' > Após concluir as configurações nos arquivos (incluindo o <code>DpSettings.xml</code>), será necessário iniciar o serviço do Windows. Siga os passos abaixo:

Linha 60:		Linha 60:
	# Certifique-se de que o status na coluna correspondente mudou para '''"Em execução"'''.[[Arquivo:Serviços - dpServerServico.png\|centro\|miniaturadaimagem\|712x712px]]		# Certifique-se de que o status na coluna correspondente mudou para '''"Em execução"'''.[[Arquivo:Serviços - dpServerServico.png\|centro\|miniaturadaimagem\|712x712px]]

	=== ~~2.4.~~ Aplicação de Atualizações (Update de Versão) ===		=== Aplicação de Atualizações (Update de Versão) ===
	* Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>C:\DpServer\Atualizacao</code>).		* Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>C:\DpServer\Atualizacao</code>).
	* Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.		* Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.