Instalação cliente nativo Windows

Pré-requisitos

Framework 4.6.2

Esta aplicação requer privilégios de administrador

Localização do instalador

O instalador está disponível na pagina da API Retail Manager, no agrupador Tools

Click to expand...

Tipos de instalação

Manual

Este modo de instalação é a ação por defeito da aplicação.

Ao executar a aplicação é apresentado o UI que permite escolher o modo de instalação pretendido, sendo apresentado contextualmente os parámetros necessários para a instalação.

Click to expand...

Silenciosa

Este tipo de instalação permite que a aplicação seja instalada de forma massiva via politicas de rede.

Para configurar esta instalação, basta editar o ficheiro Install.ini que se encontra na raiz da pasta do instalador.

Esta função está disponível para as instalações dos seguintes modos:

Online (NativeClient)
Offline (OfflinePOS)

Para ativar a instalação basta:

afectar o atributo “Install” = true do respectivo modo pretendido
e preencher os parâmetros obrigatórios

JSON

{
    "NativeClient": {
        "Install": false,
        "InstallationLocation": "C:\\CPI RETAIL\\RETAILMANAGER\\Offline",
        "Encryption": true
    },
    "OfflinePOS": {
        "Install": false,
        "InstallationLocation": "C:\\CPI RETAIL\\RETAILMANAGER\\Offline",
        "Encryption": true,
        "UseFQDNName": true,
        "APPPort": "4200",
        "APIPort": "4100",
        "MainAPISite": "https://example-api.retailmanager.pt/",
        "SignalRSite": "https://example-api.retailmanager.pt/",
        "ImageURL": "https://example-api.retailmanager.pt/",
        "DontDownloadFiles": false,
        "DontInstallSQL": false
    }
}

Logs

Em modo silencioso o estado da instalação pode ser acompanhado pelo ficheiro de log gerado na pasta \logs.

Por exemplo:

20250812 15:57:20 | Define installation type | Initiated
20250812 15:57:21 | Define installation type | Success | Offline POS
20250812 15:57:21 | Initialize API | Initiated
20250812 15:57:22 | Initialize API | Success
20250812 15:57:22 | Download files | Initiated | RM3

Modo online (NativeClient)

Parâmetros

Installation location
- Localização no disco para a instalação da aplicação
Encryption
- Se a versão instalada utiliza encriptação local
- Este parâmetro é sempre igual a “true” para versões de 2024 ou posteriores

Click to expand...

Modo offline (OfflinePOS)

Parâmetros

Installation location
- Localização no disco para a instalação da aplicação
Encryption
- Se a versão instalada utiliza encriptação local
- Este parâmetro é sempre igual a “true” para versões de 2024 ou posteriores
Use FQDN name
- Se o nome do computador local será instalado com FQDN ou só com o nome (nome.dominio.local ou nome)
APP port
- Porta que será configurado no site da APP local
API port
- Porta que será configurado no site da API local
Main API Site
- endereço da API principal
SignalR Site
- endereço da API do SignalR
- nunca pode ser uma API de loadbalancing
Image URL
- endereço do site de imagens
- pode ser idêntico à API principal
Don’t download files
- não realiza atualização dos ficheiros a partir da API principal
- utiliza os ficheiros que estejam incluidos na pasta \componentes
Don’t install SQL
- não realiza a instalação da instância do servidor SQL local (instância por defeito = localhost\RetailManager)

Click to expand...