Arquivo de configuração
O O&O DeskInfo armazena as configurações em um único arquivo XML. O menu do ícone da área de notificação dá acesso às opções de uso diário. O arquivo contém todas as configurações, incluindo margens, cores exatas, dimensões dos gráficos, histórico, mensagem da equipe de suporte e restrições para estações de trabalho gerenciadas.
Esta página descreve cada elemento do arquivo.
Local do arquivo de configuração
O nome do arquivo é sempre OODeskInfo.cfg. O O&O DeskInfo o procura na seguinte ordem:
- No caminho indicado pelo parâmetro
/cfg, se esse parâmetro tiver sido fornecido na linha de comando. - Na pasta de
OODeskInfo.exe. Se houver um arquivoOODeskInfo.cfgna pasta do programa, ele sempre será usado. Isso permite executar o aplicativo de um pen drive e levar as configurações junto com ele. - No perfil do usuário. Nos demais casos, é usado o arquivo
%LocalAppData%\OO Software\OO DeskInfo\OODeskInfo.cfg. Se ele não existir, será criado.
Para obter um arquivo válido, inicie o O&O DeskInfo, feche-o e abra o arquivo criado em %LocalAppData%\OO Software\OO DeskInfo\. Ele contém as configurações com seus valores atuais.
Estrutura e sintaxe
<?xml version="1.0"?>
<Settings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Language>en</Language>
<PanelPosition>RightTop</PanelPosition>
<TextSize>12</TextSize>
</Settings>
Ao editar o arquivo, observe as seguintes regras:
- O elemento raiz é
<Settings>e não deve declarar um namespace XML padrão. - Os nomes dos elementos diferenciam maiúsculas de minúsculas. Digite-os exatamente como aparecem nesta referência.
- Os valores booleanos são
trueoufalse, em minúsculas. - Para as cores, use um nome em inglês (
White,Black,Red,GreenouOrange) ou um valor hexadecimal no formato#RRGGBBou#AARRGGBB. - Todos os elementos são opcionais. Se um elemento estiver ausente, o programa usará o valor padrão. Assim, um arquivo com apenas duas configurações também é válido.
- A ordem dos elementos é livre. Manter a ordem usada pelo aplicativo facilita a comparação entre arquivos.
Aplicação automática das alterações
O O&O DeskInfo monitora o arquivo de configuração. Quando você salva uma alteração, o programa a detecta e aplica após cerca de um segundo. Em geral, não é necessário reiniciá-lo. Mantenha o arquivo aberto em um editor junto à área de trabalho para observar o efeito de cada mudança.
A espera de um segundo é intencional. Como alguns editores gravam os arquivos em várias etapas, o programa aguarda uma pausa na gravação para evitar ler um arquivo incompleto.
Na maioria dos casos, o aplicativo atualiza a exibição e preserva o histórico dos gráficos. As quatro configurações abaixo exigem reinicialização automática do aplicativo porque os recursos necessários são inicializados uma única vez por processo:
As alterações feitas pelo menu da área de notificação também entram em vigor imediatamente e são gravadas no arquivo.
Enquanto está em execução, o O&O DeskInfo salva dados no arquivo, como o layout de colunas em cache. Você pode editar o arquivo atual com o programa aberto. Evite substituí-lo por uma cópia anterior, pois isso restauraria valores desatualizados.
Se não conseguir interpretar o arquivo, por exemplo devido a uma tag sem fechamento, um valor inválido ou um caractere indevido, o O&O DeskInfo salva uma cópia com data e hora e extensão .invalid na mesma pasta. Depois, carrega as configurações padrão. A cópia permite corrigir o erro e recuperar os valores anteriores.
Geral
Language
Tipo: texto · Padrão: vazio (idioma do sistema)
Define o idioma da interface. Deixe o elemento vazio ou use system para acompanhar o idioma de exibição do Windows.
| Valor | Idioma |
|---|---|
(vazio) ou system | Idioma de exibição do Windows |
en | Inglês |
de | Alemão |
fr | Francês |
Essa opção também está disponível no menu da área de notificação e pelo parâmetro /lang da linha de comando.
<Language>en</Language>
LogEnabled
Tipo: booleano · Padrão: false
Grava um log detalhado em %LocalAppData%\OO Software\OO DeskInfo\Logs\OODeskInfo.log. Ative-o apenas para investigar um problema e anexe o log ao entrar em contato com o suporte.
ShowWelcome
Tipo: booleano · Padrão: true
Indica se o assistente de boas-vindas aparece ao iniciar. Após a primeira conclusão do assistente, o valor muda automaticamente para false. Defina true para exibi-lo novamente na próxima inicialização. Em um arquivo preparado para computadores gerenciados, use false para ocultá-lo desde o primeiro uso.
UpdateSpeed
Tipo: número (segundos) · Padrão: 5
Intervalo de atualização dos valores exibidos. O menu oferece 1 (Fast), 5 (Normal) e 10 (Slow). Você pode definir outro valor no arquivo. Ele aparecerá como Custom no menu. Os intervalos de medição das unidades e dos contadores de CPU e RAM são calculados a partir desse valor. Consulte Velocidade de atualização.
UseEfficiencyMode
Tipo: booleano · Padrão: true
Solicita ao Windows que execute o O&O DeskInfo em segundo plano com prioridade reduzida e, quando o hardware permitir, nos núcleos de eficiência. Essa configuração não tem efeito em versões do Windows sem Modo de Eficiência.
LaunchTaskManager
Tipo: booleano · Padrão: true
Define se um clique duplo no ícone da área de notificação abre o Gerenciador de Tarefas do Windows.
Posição e monitores
PanelPosition
Tipo: LeftTop | RightTop | LeftBottom | RightBottom · Padrão: RightTop
Define o canto da tela em que as informações aparecem.
Monitor
Tipo: número · Padrão: 0
Índice do monitor usado para a exibição, contado a partir de zero. O valor 0 corresponde ao primeiro monitor. Essa opção é ignorada quando ShowOnAllMonitors está definido como true.
ShowOnAllMonitors
Tipo: booleano · Padrão: false
Com true, as informações aparecem simultaneamente em todos os monitores conectados, com o mesmo perfil, posição e aparência.
TopMargin, RightMargin, BottomMargin, LeftMargin
Tipo: número (pixels) · Padrão: 0
Distância, em pixels, entre o painel e as bordas da tela no modo integrado à área de trabalho. Ajuste as margens para evitar a barra de tarefas, uma barra de atalhos ou um elemento do papel de parede.
<TopMargin>40</TopMargin>
<RightMargin>24</RightMargin>
<BottomMargin>0</BottomMargin>
<LeftMargin>0</LeftMargin>
IsIntegratedWithDesktop
Tipo: booleano · Padrão: true
Com true, as informações aparecem no fundo da área de trabalho, atrás dos ícones. Com false, o aplicativo usa a janela deslizante.
DisplayAlwaysOnTop
Tipo: booleano · Padrão: false
No modo de janela deslizante, mantém a janela sobre as demais.
ShowButtonOnDesktop
Tipo: booleano · Padrão: true
No modo de janela deslizante, mostra o botão da aba na borda da tela. Com false, use o ícone da área de notificação para mostrar ou ocultar a janela.
ButtonYPosition
Tipo: número · Padrão: 175
Posição vertical do botão da aba, em pixels. Normalmente você ajusta esse valor arrastando o botão com o mouse.
Aparência
AutoAdjustTextColor
Tipo: booleano · Padrão: true
Com true, escolhe automaticamente texto preto sobre um fundo claro ou branco sobre um fundo escuro, de acordo com o brilho do papel de parede, e ignora TextColor. Use false para escolher uma cor fixa.
TextColor
Tipo: cor · Padrão: White
Define a cor fixa do texto. Só tem efeito se AutoAdjustTextColor for false. Você pode especificar qualquer cor. O menu mostra Custom para valores fora de sua lista.
O menu oferece estas cores:
| Opção no menu | Valor |
|---|---|
| White | White |
| Light gray | #F2F2F2 |
| Gray | #D9D9D9 |
| Dark gray | #838383 |
| Black | Black |
| Red | Red |
| Green | Green |
| Blue | #3082CF |
TextSize
Tipo: número (pontos) · Padrão: 12
Tamanho da fonte da exibição. O menu oferece 10, 12 e 14. Outros valores podem ser definidos no arquivo e aparecem como Custom no menu.
DisplayOpacity
Tipo: número (porcentagem) · Padrão: 80
Opacidade do painel de informações inteiro. O menu oferece 100, 80 e 40.
Opacity
Tipo: número (porcentagem) · Padrão: 80
No modo de janela deslizante, define a opacidade do fundo do painel. O menu oferece 100, 80 e 40.
PanelColor
Tipo: cor · Padrão: #3082CF (azul)
No modo de janela deslizante, define a cor do botão da aba. O menu oferece azul (#3082CF), White, Black, Red, Green e laranja (#FF6A00).
FillColorNormal
Tipo: cor · Padrão: #FF82BC1D (verde)
Cor da barra de ocupação da unidade quando menos de 90% do espaço está usado.
FillColorWarning
Tipo: cor · Padrão: #FFFFBC00 (amarelo)
Cor da barra de ocupação quando o uso é de pelo menos 90% e inferior a 95%.
FillColorCritical
Tipo: cor · Padrão: #FFDD4A17 (vermelho)
Cor da barra de ocupação quando o uso chega a 95% ou mais.
FillColorBackground
Tipo: cor · Padrão: #FF838383 (cinza)
Cor de fundo da barra de ocupação da unidade.
Distribuição das colunas
UseBalancedColumnDistribution
Tipo: booleano · Padrão: true
Com true, o programa distribui as informações por peso entre as colunas. Cada linha de rótulo e cada unidade contam como 1. O peso de um gráfico é proporcional à sua altura. Os grupos permanecem inteiros. Com false, as informações são distribuídas sequencialmente.
BalancedColumnAlignment
Tipo: RightBound | LeftBound · Padrão: RightBound
Define qual coluna pode ficar mais curta quando não é possível equilibrá-las exatamente. Com RightBound, a coluna da esquerda pode ficar mais curta, o que favorece o alinhamento à direita. Com LeftBound, a coluna da direita pode ficar mais curta, favorecendo o alinhamento à esquerda.
Gráficos e monitoramento de desempenho
ShowCPUGraph
Tipo: booleano · Padrão: true
Mostra o gráfico de histórico da CPU se ele estiver incluído no perfil ativo.
ShowRAMGraph
Tipo: booleano · Padrão: true
Mostra o gráfico de histórico da RAM se ele estiver incluído no perfil ativo.
ShowGPUGraph
Tipo: booleano · Padrão: true
Mostra o gráfico de histórico da GPU se ele estiver incluído no perfil ativo. As linhas de GPU ficam ocultas em sistemas que não informam esses dados.
ShowNetworkGraph
Tipo: booleano · Padrão: true
Mostra os dois gráficos de tráfego de rede, de envio e de recebimento, se estiverem incluídos no perfil ativo.
ShowNetworkTrafficInBitsPerSecond
Tipo: booleano · Padrão: true
Com true, o tráfego é exibido em bits por segundo com prefixos decimais (b/s, Kb/s, Mb/s, Gb/s). Com false, é exibido em bytes por segundo com prefixos binários, identificados na interface por B/s, KB/s, MB/s e GB/s.
PerformanceGraphHeight
Tipo: número (pixels) · Padrão: 48
Altura de cada gráfico de desempenho. Gráficos mais altos facilitam a visualização de pequenas variações, mas recebem mais peso na distribuição das colunas.
PerformanceGraphMinWidth
Tipo: número (pixels) · Padrão: 200
Largura mínima de cada gráfico de desempenho. O gráfico pode ficar mais largo para preencher o espaço disponível na coluna.
MaxHistoryItems
Tipo: número · Padrão: 1024
Número de amostras mantidas por métrica. Em intervalos de atualização típicos, 1.024 amostras correspondem a cerca de 17 a 34 minutos. Aumente o valor para avaliar mínimos e máximos em um período mais longo ou reduza-o para economizar memória.
PerformanceAverageMinSampleCount
Tipo: número · Padrão: 32
Número mínimo de amostras antes de exibir uma média. Isso evita grandes oscilações logo após a inicialização. O limite interno é o valor de MaxHistoryItems.
Unidades e dispositivos USB
ShowDriveActivity
Tipo: booleano · Padrão: true
Mostra os indicadores de atividade de leitura e gravação de cada unidade.
ShowUnknownUSBDeviceNotification
Tipo: booleano · Padrão: false
Exibe uma notificação ao conectar um dispositivo de armazenamento USB que ainda não foi marcado como confiável.
TrustedUSBDevices
Tipo: lista de textos · Padrão: vazio
Lista dos dispositivos USB marcados permanentemente como confiáveis. Remova uma entrada para voltar a receber o aviso ao conectar aquele dispositivo ou remova todo o elemento para redefinir todas as decisões.
<TrustedUSBDevices>
<string>USBSTOR\DISK&VEN_SANDISK&PROD_ULTRA&REV_1.00\4C530001…</string>
</TrustedUSBDevices>
Rede
NetworkAdapter
Tipo: texto · Padrão: vazio (automático)
Descrição do adaptador de rede cujos dados serão exibidos. Omita o elemento para ativar a seleção automática. O texto deve corresponder exatamente à descrição fornecida pelo Windows. Para obtê-lo, escolha o adaptador no menu da área de notificação e consulte o valor gravado no arquivo.
Perfis
SelectedProfile
Tipo: texto · Padrão: Default
Define qual perfil está ativo.
| Valor | Perfil |
|---|---|
Default | Perfil padrão |
Full | Perfil completo |
Minimum | Perfil mínimo |
DriveLED | Somente unidades |
| qualquer outro valor | O perfil definido em CustomProfile |
CustomProfile
Tipo: elemento · Padrão: nenhum
Definição do seu perfil personalizado. Consulte a estrutura e a lista de chaves em Perfis de exibição.
<CustomProfile>
<Name>Custom</Name>
<DisplayName>IT Support Profile</DisplayName>
<ShowLabels>true</ShowLabels>
<Keys>
<Item>InfoMessage</Item>
<Item>-</Item>
<Item>UserAndMachine</Item>
<Item>-</Item>
<Item>OS</Item>
</Keys>
<ColumnAssignments>InfoMessage:0;UserAndMachine:0;OS:0</ColumnAssignments>
</CustomProfile>
Implantação e restrições
Estas quatro configurações se destinam a ambientes gerenciados. Consulte Implantação em empresas para saber como combiná-las.
InfoMessage
Tipo: texto · Padrão: vazio
Linha de texto exibida acima das informações do sistema, normalmente com os dados de contato da equipe de suporte. Só aparece se o perfil ativo incluir a chave InfoMessage, presente em todos os perfis predefinidos.
<InfoMessage>IT Help Desk: helpdesk@example.com | Phone: +49 30 1234-5678</InfoMessage>
SetAutoRun
Tipo: booleano · Padrão: não definido
Define a inicialização automática sem solicitar confirmação ao usuário. Com true, a entrada é criada. Com false, ela é removida. Se o elemento for omitido, a preferência configurada pelo usuário será mantida.
IsRestricted
Tipo: booleano · Padrão: não definido
Com true, o O&O DeskInfo entra em modo somente leitura. O programa deixa de gravar no arquivo de configuração e de exibir o menu da área de notificação. Dessa forma, a configuração distribuída não pode ser alterada acidentalmente pelo usuário por meio desses controles.
TrayMenu
Tipo: Full | ExitOnly | HideMenu | HideAll · Padrão: Full
Define a visibilidade do ícone da área de notificação e das opções do menu.
| Valor | Ícone da área de notificação | Menu |
|---|---|---|
Full | visível | completo |
ExitOnly | visível | somente Quit |
HideMenu | visível | nenhum |
HideAll | oculto | nenhum |
Valores gerenciados pelo aplicativo
Esses elementos são gerenciados pelo próprio O&O DeskInfo. Não é preciso editá-los. Omita-os ao preparar um arquivo para distribuição.
| Elemento | Significado |
|---|---|
NewsletterSubscribed | Indica se o usuário assinou a newsletter pela visão geral dos produtos. |
ScrollViewerPosition | Posição de rolagem da exibição. |
SavedColumnLayout | Última distribuição de colunas calculada, guardada em cache para agilizar a inicialização. |
LayoutEnvironmentFingerprint | Identificador do ambiente de exibição (monitor, resolução, tamanho do texto, DPI e perfil) usado para determinar quando recalcular o layout. |
WindowPosition, AppViewMode | Herdados da base de configurações compartilhada da O&O. O O&O DeskInfo não usa esses elementos. |
Exemplo completo
Neste exemplo de uma estação de suporte, a interface está em alemão, o painel aparece no canto inferior esquerdo com texto grande, e a mensagem de contato fica visível. A inicialização automática é obrigatória e os controles do usuário são restritos.
<?xml version="1.0"?>
<Settings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!-- General -->
<Language>de</Language>
<LogEnabled>false</LogEnabled>
<ShowWelcome>false</ShowWelcome>
<UpdateSpeed>5</UpdateSpeed>
<!-- Position -->
<PanelPosition>LeftBottom</PanelPosition>
<Monitor>0</Monitor>
<ShowOnAllMonitors>false</ShowOnAllMonitors>
<IsIntegratedWithDesktop>true</IsIntegratedWithDesktop>
<TopMargin>0</TopMargin>
<BottomMargin>48</BottomMargin>
<LeftMargin>24</LeftMargin>
<!-- Appearance -->
<AutoAdjustTextColor>true</AutoAdjustTextColor>
<TextSize>14</TextSize>
<DisplayOpacity>100</DisplayOpacity>
<UseBalancedColumnDistribution>true</UseBalancedColumnDistribution>
<BalancedColumnAlignment>LeftBound</BalancedColumnAlignment>
<!-- Graphs -->
<ShowCPUGraph>true</ShowCPUGraph>
<ShowRAMGraph>true</ShowRAMGraph>
<ShowGPUGraph>false</ShowGPUGraph>
<ShowNetworkGraph>true</ShowNetworkGraph>
<ShowNetworkTrafficInBitsPerSecond>true</ShowNetworkTrafficInBitsPerSecond>
<PerformanceGraphHeight>64</PerformanceGraphHeight>
<!-- Drives and USB -->
<ShowDriveActivity>true</ShowDriveActivity>
<ShowUnknownUSBDeviceNotification>true</ShowUnknownUSBDeviceNotification>
<!-- Profile -->
<SelectedProfile>Custom</SelectedProfile>
<CustomProfile>
<Name>Custom</Name>
<DisplayName>Support</DisplayName>
<ShowLabels>true</ShowLabels>
<Keys>
<Item>InfoMessage</Item>
<Item>-</Item>
<Item>UserAndMachine</Item>
<Item>-</Item>
<Item>OS</Item>
<Item>-</Item>
<Item>CPU</Item>
<Item>-</Item>
<Item>NetworkBasic</Item>
<Item>-</Item>
<Item>LocalDrives</Item>
<Item>-</Item>
<Item>Performance</Item>
</Keys>
<ColumnAssignments>InfoMessage:0;UserAndMachine:0;OS:0;CPU:0;NetworkBasic:1;LocalDrives:1;Performance:2</ColumnAssignments>
</CustomProfile>
<!-- Deployment -->
<InfoMessage>IT Help Desk: helpdesk@example.com | Phone: +49 30 1234-5678</InfoMessage>
<SetAutoRun>true</SetAutoRun>
<IsRestricted>true</IsRestricted>
<TrayMenu>ExitOnly</TrayMenu>
</Settings>
Você pode incluir comentários XML (<!-- … -->) enquanto edita o arquivo. O O&O DeskInfo remove os comentários quando grava suas configurações. Mantenha a cópia principal comentada no compartilhamento de distribuição.